API voor duidelijke taal en eenvoudige taal.
Stuur uw brontekst, de gewenste doeltaal en een van de twee taalmodi. Simple8 herkent automatisch de brontaal en geeft de voltooide tekst terug in de doeltaal.
{
"text": "Complexe broninhoud in de geselecteerde taal.",
"locale": "nl",
"mode": "simple-language"
}SDK- en cURL-voorbeelden beschikbaar
Eindpunt
POST /api/v2/translate
Maakt een tekst in eenvoudige of eenvoudige taal en geeft deze direct terug in de HTTP-respons.
Verplicht hoofdstukken
| Inschrift | De waarde | Doel |
|---|---|---|
| Authorization | Bearer <API_KEY> | Werkruimteverificatie |
| Content-Type | aanvraag/json | Geeft aan dat het verzoek JSON bevat |
| Accept | aanvraag/json | Verzoek een JSON-reactie |
| Idempotency-Key | Alleen vereist voor achtergrond- en bulkorders | Voorkomt dubbele achtergrondorders |
Verzoekingsinstantie
Er is geen andere inhoudsinstelling die deel uitmaakt van het openbare verzoekschema.
| Veld | Type | Verplichting | Toegestane waarde | Beschrijving |
|---|---|---|---|---|
| text | stroom | - Ja, dat is het. | 1 tot 5.000 NFC-genormaliseerde Unicode-codepunten | Brontekst |
| locale | stroom | - Ja, dat is het. | Een van de 136 ondersteunde codes van 2 of 3 letters | Uitvoertaal. De brontaal wordt automatisch gedetecteerd. |
| mode | stroom | - Ja, dat is het. | simple-language, easy-language | Eenvoudigingsmodus |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Reactie-organisme
Het antwoord bevat de voltooide tekst en de gedocumenteerde gebruiksgegevens.
| Veld | Type | Beschrijving |
|---|---|---|
| requestId | stroom | Unieke identificatiecode voor ondersteuning en logs |
| locale | stroom | Geselecteerde doeltaal |
| mode | stroom | Selecteerde vereenvoudigingsmodus |
| output | stroom | Tekst klaarmaken in de geselecteerde doeltaal |
| usage.inputCharacters | een geheel getal | Tekens geteld voor dit verzoek, of 0 voor een cachetreffer |
| usage.cacheHit | Booleaans | Of het resultaat afkomstig is van de 180-dagencache |
{
"requestId": "req_sync_002",
"locale": "en",
"mode": "easy-language",
"output": "You need to send documents.\nSend the documents before the deadline.",
"usage": {
"inputCharacters": 78,
"cacheHit": false
}
}Valideringsgedrag
- Ontbrekende, lege, onbekende of ongeldige velden retourneren HTTP 400 met foutcode invalid_request en validatiedetails.
- De tekstlengte wordt na NFC-normalisatie gemeten in Unicode-codepunten.
- De landinstelling moet een van de 136 gedocumenteerde codes van 2 of 3 letters zijn.
- De modus moet exact simple-language of easy-language zijn.
- Simple8 herkent automatisch de taal van de brontekst en creëert het resultaat in de geselecteerde doeltaal.