Kijk eerst naar de statuscode van de foutmelding. Die vertelt meestal wat er misgaat, zoals een ongeldig token, te weinig tekst of een domein dat niet bij Tolkie bekend is. In de tabel hieronder lees je wat je zelf kunt doen. Kom je er niet uit? Mail dan [email protected] met de gegevens die verderop staan.
Wat betekent de foutcode?
Code | API | Wat betekent het? | Wat kun je doen? |
400 | Text Simplification API | Het veld text ontbreekt, of de tekst is korter dan 250 tekens. | Stuur de volledige tekst mee, met minimaal 250 tekens. |
400 | Simpele tekst API | Een veld is niet goed ingevuld, of de tekst is samen korter dan 150 tekens. | Controleer de velden text_list en url_field. Stuur minimaal 150 tekens tekst mee. |
400 | Translation API | De JSON klopt niet, of een veld is niet goed. Bijvoorbeeld een taalcode die niet wordt ondersteund, of een ontbrekend url_field. | Controleer de taalcode. De foutmelding noemt de codes die wel werken. Stuur altijd een url_field mee met de volledige URL van de pagina. |
401 | Alle API's | Het token ontbreekt of klopt niet. | Controleer de header: Authorization: Token jouw-token. Let op het woord Token, met een spatie tussen Token en je token. Klopt alles en blijft de fout? Mail support. |
403 | Translation API | Het domein in de Origin-header of in url_field is niet bekend bij Tolkie voor jouw organisatie. | Controleer of je de aanvraag doet vanaf je eigen domein en of url_field de volledige URL van die pagina is. Gebruik je een nieuw domein? Mail support met de domeinen die je wilt gebruiken. |
403 | Simpele tekst API | De simpele teksten staan uit voor jouw account. | Mail support. |
404 | Text Simplification API | Het token is geldig, maar er hoort geen organisatie bij. | Mail support. |
500 | Text Simplification API | De tekst is leeg of bestaat alleen uit spaties. | Controleer of je systeem echt tekst meestuurt. |
200 met {} | Simpele tekst API | Er kon geen simpele tekst worden gemaakt. | Controleer of je genoeg lopende tekst meestuurt. Blijft het gebeuren? Mail support. |
Wat is de X-Request-ID?
Elk antwoord van een Tolkie API bevat een X-Request-ID. Dat is een code waarmee support jouw aanvraag terugvindt. Je kunt ook zelf een X-Request-ID meesturen, zodat je een aanvraag in je eigen systeem makkelijk kunt volgen. Die mag 1 tot 64 tekens lang zijn, met letters, cijfers en streepjes. Bij een fout in de invoer staat de code soms ook als request_id in de foutmelding.
X-Request-ID: jouw-eigen-code-123
Wat stuur ik mee aan support?
Mail [email protected] en stuur dit mee. Zo vinden we je aanvraag snel terug:
de X-Request-ID van de aanvraag;
het endpoint dat je aanroept, bijvoorbeeld /api/v1/tolkie/simplify_text;
de datum en het tijdstip van de aanvraag;
de statuscode;
de foutmelding die je terugkreeg;
bij de Translation API: de Origin-header en het url_field die je meestuurde.
Stuur nooit je token mee. Behandel het token als een wachtwoord. Support heeft het niet nodig om je te helpen.