Translator 3.0: BreakSentence
Identificeert de positie van zinsgrenzen in een stuk tekst.
Aanvraag-URL
Een aanvraag POST
versturen naar:
https://api.cognitive.microsofttranslator.com/breaksentence?api-version=3.0
ZieVirtual Network Support for Translator Service selected network and private endpoint configuration and support (Ondersteuning voor geselecteerde netwerk- en privé-eindpunten).
Aanvraagparameters
Aanvraagparameters die worden doorgegeven aan de querytekenreeks zijn:
Queryparameter | Description |
---|---|
api-versie | Vereiste queryparameter. Versie van de API die door de client is aangevraagd. De waarde moet zijn 3.0 . |
language | Optionele queryparameter. Taaltag die de taal van de invoertekst identificeert. Als er geen code is opgegeven, wordt automatische taaldetectie toegepast. |
script | Optionele queryparameter. Scripttag die het script identificeert dat door de invoertekst wordt gebruikt. Als er geen script is opgegeven, wordt uitgegaan van het standaardscript van de taal. |
Aanvraagheaders zijn onder andere:
Kopteksten | Beschrijving |
---|---|
Verificatieheader(s) | Vereiste aanvraagheader. Zie 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
. Zinsgrenzen worden berekend voor de waarde van de Text
eigenschap. Een voorbeeld van een aanvraagbody met één stuk tekst ziet er als volgt uit:
[
{ "Text": "How are you? I am fine. What did you do today?" }
]
De volgende beperkingen zijn van toepassing:
- De matrix kan maximaal 100 elementen bevatten.
- De tekstwaarde van een matrixelement mag niet groter zijn dan 50.000 tekens, inclusief spaties.
- De volledige tekst in de aanvraag mag niet langer zijn dan 50.000 tekens, inclusief spaties.
- Als de
language
queryparameter is opgegeven, moeten alle matrixelementen zich in dezelfde taal bevinden. Anders wordt automatisch taaldetection op elk matrixelement afzonderlijk toegepast.
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:
sentLen
: Een matrix met gehele getallen die de lengte van de zinnen in het tekstelement vertegenwoordigen. De lengte van de matrix is het aantal zinnen en de waarden zijn de lengte van elke zin.detectedLanguage
: Een object dat de gedetecteerde taal beschrijft via de volgende eigenschappen:language
: Code van de gedetecteerde taal.score
: Een float-waarde die de betrouwbaarheid in het resultaat aangeeft. De score ligt tussen nul (0) en één (1,0). Een lage score (<= 0,4) duidt op een lage betrouwbaarheid.
De detectedLanguage
eigenschap is alleen aanwezig in het resultaatobject wanneer automatische taaldetectie wordt aangevraagd.
Een voorbeeld van een JSON-antwoord is:
[
{
"detectedLanguage": {
"language": "en",
"score": 1.0
},
"sentLen": [
13,
11,
22
]
}
]
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 antwoordcode geeft vaak aan dat alle gratis vertalingen die bij een proefabonnement worden geleverd, 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 getal 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 zinsgrenzen voor één zin kunt verkrijgen. De service detecteert automatisch de zinstaal.
curl -X POST "https://api.cognitive.microsofttranslator.com/breaksentence?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'How are you? I am fine. What did you do today?'}]"