Schone Liedjes Tekstanalyse

Een deterministische API voor het controleren van door de klant aangeleverde tekst in het Portugees en Engels op godslastering, drugsverwijzingen, geweld en expliciete seksuele inhoud.

Selecteer de categorieën die je wilt controleren, voeg aangepaste termen toe en markeer zinnen voor menselijke beoordeling. Resultaten bevatten een classificatie, minimaal overeenkomend bewijs, regelnummers en een versiebeheerde regelset.

Authenticatie

Stuur je Oanor-abonnementssleutel mee in de request-header:

x-oanor-key: YOUR_OANOR_API_KEY

Gebruik de gateway-URL die op de Oanor-vermelding van deze API wordt weergegeven.

Endpoints

Tekst analyseren

Stuur een JSON-body met de header Content-Type: application/json.

{
  "text": "What a peaceful day.",
  "language": "en",
  "rules": [
    "profanity",
    "drugs",
    "violence",
    "sexual_content"
  ],
  "custom_terms": [],
  "review_contexts": []
}

Request-velden

Elke optionele lijst accepteert maximaal 20 termen, met maximaal 80 tekens per term. Onbekende velden worden geweigerd.

Voorbeeldrespons

{
  "status": "approved",
  "rule_version": "text-1.0/rules-2026.2",
  "language": "en",
  "violations": [],
  "summary": "No matches found for the selected rules.",
  "truncated": false
}

Resultaatstatussen

• approved — Er zijn geen overeenkomsten gevonden onder de geselecteerde regels.
• rejected — Er is een expliciete categorie- of aangepaste-term-overeenkomst gevonden.
• review_required — Ambigue termen of beoordelingszinnen vereisen menselijke beoordeling.

Bevindingen bevatten rule, severity, evidence, line, reason en confidence. Bewijs is beperkt tot het overeenkomende token of de overeenkomende zin, tot 160 tekens. Regelnummers beginnen bij 1.

Confidence-waarden zijn vaste detectorscores, geen gekalibreerde waarschijnlijkheden.

curl-voorbeeld

Vervang YOUR_API_SLUG door de slug die op deze vermelding wordt weergegeven.

curl --request POST \
  "https://api.oanor.com/YOUR_API_SLUG/v1/analyze-text" \
  --header "x-oanor-key: ${OANOR_API_KEY}" \
  --header "Content-Type: application/json" \
  --data '{
    "text": "What a peaceful day.",
    "language": "en",
    "rules": ["profanity", "drugs", "violence", "sexual_content"],
    "custom_terms": [],
    "review_contexts": []
  }'

Limieten en fouten

• Maximale tekstlengte: 7.000 tekens.
• Maximale volledige request-body: 65.536 bytes.
• Maximaal geretourneerde bevindingen: 200. Bij extra bevindingen wordt truncated op true gezet; afgekapte resultaten worden nooit goedgekeurd.
• Snelheidslimieten en maandelijkse quota's zijn afhankelijk van je abonnementsplan.
• Responses gebruiken Cache-Control: no-store.

Respecteer, indien aanwezig, de Retry-After-header voordat je het opnieuw probeert.

Privacy en inhoudsrechten

De analyse-backend verwerkt ingediende tekst zonder deze op te slaan in een database, geschiedenis of resultatencache. Applicatielogs sluiten ingediende inhoud en inloggegevens uit. Het beleid voor gateway- en hostingmetadata staat hier los van.

Dien alleen inhoud in waarvoor je de benodigde rechten en toestemmingen hebt. Deze API zoekt niet naar songteksten, haalt deze niet op en levert deze niet; een abonnement verleent geen rechten op inhoud van derden.

Belangrijke beperkingen

Classificatie gebruikt lexicale regels, inclusief normalisatie van hoofdletters/accenten en woordstammen. Het interpreteert intentie, ironie, ontkenning of bredere betekenis niet betrouwbaar.

Een approved-resultaat betekent dat er onder de geselecteerde regels geen signalen zijn gedetecteerd. Het is geen garantie voor veiligheid, geschiktheid, legaliteit of auteursrechtelijke vrijwaring. Gebruik menselijke beoordeling voor ambigue of gevoelige beslissingen.