Translator 3.0: Identifiera

  • Artikel

Identifierar språket i ett textstycke.

Begärans-URL

Skicka en POST-begäran till:

https://api.cognitive.microsofttranslator.com/detect?api-version=3.0

SeVirtual Network Support för Translator-tjänstens valda konfiguration och support för nätverk och privat slutpunkt.

Parametrar för begäran

Begäransparametrar som skickas på frågesträngen är:

Frågeparameter Beskrivning
api-version Obligatorisk parameter.
Version av API:et som begärs av klienten. Värdet måste vara 3.0.

Begärandehuvuden är:

Sidhuvuden Description
Autentiseringshuvuden Obligatoriskt begärandehuvud.
Se tillgängliga alternativ för autentisering.
Content-Type Obligatoriskt begärandehuvud.
Anger nyttolastens innehållstyp. Möjliga värden är: application/json.
Innehållslängd Obligatoriskt begärandehuvud.
Längden på begärandetexten.
X-ClientTraceId Valfritt.
Ett klientgenererat GUID för att unikt identifiera begäran. Du kan utelämna det här huvudet om du inkluderar spårnings-ID:t i frågesträngen med hjälp av en frågeparameter med namnet ClientTraceId.

Begärandetext

Brödtexten i begäran är en JSON-matris. Varje matriselement är ett JSON-objekt med en strängegenskap med namnet Text. Språkidentifiering tillämpas på värdet för Text egenskapen . Språk autodetection fungerar bättre med längre indatatext. Ett exempel på begärandetexten ser ut så här:

[
    { "Text": "Ich würde wirklich gerne Ihr Auto ein paar Mal um den Block fahren." }
]

Följande begränsningar gäller:

  • Matrisen kan innehålla högst 100 element.
  • Hela texten som ingår i begäran får inte överstiga 50 000 tecken, inklusive blanksteg.

Själva svaret

Ett lyckat svar är en JSON-matris med ett resultat för varje sträng i indatamatrisen. Ett resultatobjekt innehåller följande egenskaper:

  • language: Kod för det identifierade språket.

  • score: Ett flyttalsvärde som anger resultatets konfidens. Poängen är mellan noll och en och en låg poäng indikerar ett lågt förtroende.

  • isTranslationSupported: Ett booleskt värde som är sant om det identifierade språket är ett av de språk som stöds för textöversättning.

  • isTransliterationSupported: Ett booleskt värde som är sant om det identifierade språket är ett av de språk som stöds för transkribering.

  • alternatives: En matris med andra möjliga språk. Varje element i matrisen är ett annat objekt med följande egenskaper: language, isTranslationSupportedscoreoch isTransliterationSupported.

Ett exempel på ett JSON-svar är:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

Svarshuvuden

Sidhuvuden Description
X-RequestId Värde som genereras av tjänsten för att identifiera begäran. Den används i felsökningssyfte.

Svarsstatuskoder

Följande är de möjliga HTTP-statuskoder som en begäran returnerar.

Statuskod Description
200 Åtgärden lyckades.
400 En av frågeparametrarna saknas eller är ogiltig. Korrigera begärandeparametrarna innan du försöker igen.
401 Det gick inte att autentisera begäran. Kontrollera att autentiseringsuppgifterna har angetts och är giltiga.
403 Begäran har inte behörighet. Kontrollera informationsfelmeddelandet. Den här koden anger ofta att alla kostnadsfria översättningar som medföljer en utvärderingsprenumeration har förbrukats.
429 Servern avvisade begäran eftersom klienten har överskridit begärandegränserna.
500 Det uppstod ett oväntat fel. Om felet kvarstår rapporterar du det med: datum och tid för felet, begärandeidentifierare från svarshuvudet X-RequestIdoch klientidentifierare från begärandehuvudet X-ClientTraceId.
503 Servern är inte tillgänglig för tillfället. Försök igen med begäran. Om felet kvarstår rapporterar du det med: datum och tid för felet, begärandeidentifierare från svarshuvudet X-RequestIdoch klientidentifierare från begärandehuvudet X-ClientTraceId.

Om ett fel inträffar returnerar begäran ett JSON-felsvar. Felkoden är ett 6-siffrigt tal som kombinerar den tresiffriga HTTP-statuskoden följt av ett 3-siffrigt tal för att ytterligare kategorisera felet. Vanliga felkoder finns på referenssidan för Translator v3.

Exempel

I följande exempel visas hur du hämtar språk som stöds för textöversättning.

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?'}]"