Translator 3.0: Detecteren
Identificeert de taal van een stuk tekst.
Aanvraag-URL
Een aanvraag POST
versturen naar:
https://api.cognitive.microsofttranslator.com/detect?api-version=3.0
ZieVirtual Network Ondersteuning voor geselecteerde netwerk- en privé-eindpuntconfiguratie en -ondersteuning voor De Translator-service.
Aanvraagparameters
Aanvraagparameters die zijn doorgegeven aan de queryreeks zijn:
Queryparameter | Beschrijving |
---|---|
api-versie | Vereiste parameter. Versie van de API die door de client is aangevraagd. De waarde moet zijn 3.0 . |
Aanvraagheaders zijn onder andere:
Kopteksten | Beschrijving |
---|---|
Verificatieheader(s) | Vereiste aanvraagheader. Bekijk de beschikbare opties voor verificatie. |
Content-Type | Vereiste aanvraagheader. Hiermee geeft u het inhoudstype van de payload op. Mogelijke waarden zijn: application/json . |
Content-Length | Vereiste aanvraagheader. De lengte van de aanvraagtekst. |
X-ClientTraceId | Optioneel. Een door de client gegenereerde GUID om de aanvraag op unieke wijze te identificeren. U kunt deze header weglaten als u de tracerings-id in de queryreeks opneemt middels een queryparameter met de naam ClientTraceId . |
Aanvraagbody
De hoofdtekst van de aanvraag is een JSON-matrix. Elk matrixelement is een JSON-object met een tekenreekseigenschap met de naam Text
. Taaldetectie wordt toegepast op de waarde van de Text
eigenschap. De automatische taaldesectie werkt beter met langere invoertekst. Een voorbeeld van de aanvraagbody ziet er als volgt uit:
[
{ "Text": "Ich würde wirklich gerne Ihr Auto ein paar Mal um den Block fahren." }
]
De volgende beperkingen zijn van toepassing:
- De matrix kan maximaal 100 elementen bevatten.
- De volledige tekst in de aanvraag mag niet langer zijn dan 50.000 tekens, inclusief spaties.
Hoofdtekst van de reactie
Een geslaagd antwoord is een JSON-matrix met één resultaat voor elke tekenreeks in de invoermatrix. Een resultaatobject bevat de volgende eigenschappen:
language
: Code van de gedetecteerde taal.score
: Een floatwaarde die de betrouwbaarheid in het resultaat aangeeft. De score ligt tussen nul en één en een lage score geeft een lage betrouwbaarheid aan.isTranslationSupported
: Een booleaanse waarde die true is als de gedetecteerde taal een van de talen is die worden ondersteund voor tekstvertaling.isTransliterationSupported
: Een booleaanse waarde die waar is als de gedetecteerde taal een van de talen is die worden ondersteund voor transliteratie.alternatives
: Een matrix met andere mogelijke talen. Elk element van de matrix is een ander object met de volgende eigenschappen:language
,score
enisTranslationSupported
isTransliterationSupported
.
Een voorbeeld van een JSON-antwoord is:
[
{
"language": "de",
"score": 1.0,
"isTranslationSupported": true,
"isTransliterationSupported": false
}
]
Antwoordheaders
Kopteksten | Beschrijving |
---|---|
X-RequestId | Waarde die door de service wordt gegenereerd om de aanvraag te identificeren. Het wordt gebruikt voor probleemoplossingsdoeleinden. |
Antwoordstatuscodes
Hier volgen de mogelijke HTTP-statuscodes die een aanvraag retourneert.
Statuscode | Description |
---|---|
200 | Voltooid. |
400 | Een van de queryparameters ontbreekt of is ongeldig. Corrigeer aanvraagparameters voordat u het opnieuw probeert. |
401 | De aanvraag kan niet worden geverifieerd. Controleer of de referenties zijn opgegeven en geldig zijn. |
403 | De aanvraag is niet geautoriseerd. Controleer het foutbericht met details. Deze code geeft vaak aan dat alle gratis vertalingen met een proefabonnement zijn opgebruikt. |
429 | De server heeft de aanvraag afgewezen omdat de client de aanvraaglimieten heeft overschreden. |
500 | Er is een onverwachte fout opgetreden. Als de fout zich blijft voordoen, meldt u deze met: datum en tijd van de fout, aanvraag-id van antwoordheader X-RequestId en client-id van aanvraagheader X-ClientTraceId . |
503 | Server tijdelijk niet beschikbaar. Probeer de aanvraag opnieuw. Als de fout zich blijft voordoen, meldt u deze met: datum en tijd van de fout, aanvraag-id van antwoordheader X-RequestId en client-id van aanvraagheader X-ClientTraceId . |
Als er een fout optreedt, retourneert de aanvraag een JSON-foutreactie. De foutcode is een 6-cijferig getal dat de 3-cijferige HTTP-statuscode combineert, gevolgd door een 3-cijferig nummer om de fout verder te categoriseren. Algemene foutcodes vindt u op de naslagpagina van v3 Translator.
Voorbeelden
In het volgende voorbeeld ziet u hoe u talen ophaalt die worden ondersteund voor tekstvertaling.
curl -X POST "https://api.cognitive.microsofttranslator.com/detect?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'What language is this text written in?'}]"