Translator 3.0: Transliteratie

Artikel
09/22/2023

Converteert tekst in één taal van het ene script naar een ander script.

Aanvraag-URL

Een aanvraag POST versturen naar:

https://api.cognitive.microsofttranslator.com/transliterate?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`.
language	Vereiste parameter. Hiermee geeft u de taal op van de tekst die moet worden geconverteerd van het ene script naar het andere. Mogelijke talen worden vermeld in het `transliteration` bereik dat is verkregen door een query uit te voeren op de ondersteunde talen van de service.
fromScript	Vereiste parameter. Hiermee geeft u het script op dat wordt gebruikt door de invoertekst. Zoek ondersteunde talen op met behulp van het `transliteration` bereik om invoerscripts te vinden die beschikbaar zijn voor de geselecteerde taal.
toScript	Vereiste parameter. Hiermee geeft u het uitvoerscript op. Zoek ondersteunde talen op met behulp van het `transliteration` bereik om uitvoerscripts te vinden die beschikbaar zijn voor de geselecteerde combinatie van invoertaal en invoerscript.

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, die de te converteren tekenreeks vertegenwoordigt.

[
    {"Text":"こんにちは"},
    {"Text":"さようなら"}
]

De volgende beperkingen zijn van toepassing:

De matrix kan maximaal 10 elementen bevatten.
De tekstwaarde van een matrixelement mag niet groter zijn dan 1000 tekens, inclusief spaties.
De volledige tekst in de aanvraag mag niet langer zijn dan 5000 tekens, inclusief spaties.

Hoofdtekst van de reactie

Een geslaagd antwoord is een JSON-matrix met één resultaat voor elk element in de invoermatrix. Een resultaatobject bevat de volgende eigenschappen:

text: Een tekenreeks die het resultaat is van het converteren van de invoertekenreeks naar het uitvoerscript.
script: Een tekenreeks die het script aangeeft dat in de uitvoer wordt gebruikt.

Een voorbeeld van een JSON-antwoord is:

[
    {"text":"konnnichiha","script":"Latn"},
    {"text":"sayounara","script":"Latn"}
]

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 ook 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 twee Japanse tekenreeksen converteert naar ge romaniseerd Japans.

De JSON-nettolading voor de aanvraag in dit voorbeeld:

[{"text":"こんにちは","script":"jpan"},{"text":"さようなら","script":"jpan"}]

Als u cURL gebruikt in een opdrachtregelvenster dat geen Unicode-tekens ondersteunt, neemt u de volgende JSON-nettolading en slaat u deze op in een bestand met de naam request.txt. Zorg ervoor dat u het bestand met UTF-8 codering opslaat.

curl -X POST "https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn" -H "X-ClientTraceId: 875030C7-5380-40B8-8A03-63DACCF69C11" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d @request.txt

Share via