Container: Tekst transliteratie

Artikel
09/01/2024

Converteer tekens of letters van een brontaal naar de bijbehorende tekens of letters van een doeltaal.

Aanvraag-URL

POST verzoek:

 POST http://localhost:{port}/transliterate?api-version=3.0&language={language}&fromScript={fromScript}&toScript={toScript}

Zie Virtual Network Support for Translator service selected network and private endpoint configuration and support.

Aanvraagparameters

Aanvraagparameters die worden doorgegeven aan de queryreeks zijn:

Queryparameter	Beschrijving	Voorwaarde
api-versie	Versie van de API die door de client is aangevraagd. Waarde moet zijn `3.0`.	Vereiste parameter
language	Hiermee geeft u de brontaal van de tekst die van het ene script naar het andere moet worden geconverteerd.	Vereiste parameter
fromScript	Hiermee geeft u het script op dat wordt gebruikt door de invoertekst.	Vereiste parameter
toScript	Hiermee geeft u het uitvoerscript.	Vereiste parameter

U kunt een query uitvoeren op de service voor transliteration ondersteunde talen voor bereiken.
Zie ook Taalondersteuning voor transliteratie.

Aanvraagheaders

Kopteksten	Beschrijving	Voorwaarde
Verificatieheaders	Beschikbare opties voor verificatie bekijken	Vereiste aanvraagheader
Inhoudstype	Hiermee geeft u het inhoudstype van de payload op. Mogelijke waarde: `application/json`	Vereiste aanvraagheader
Content-Length	De lengte van de aanvraagtekst.	Optioneel
X-ClientTraceId	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`.	Optioneel

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 opgeeft dat in de uitvoer wordt gebruikt.

Responsheaders

Kopteksten	Beschrijving
X-RequestId	De waarde die door de service wordt gegenereerd om de aanvraag te identificeren. Het kan worden gebruikt voor probleemoplossingsdoeleinden.

Voorbeeldaanvraag

curl -X POST "http://localhost:5000/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn"

Tekst van voorbeeldaanvraag

De hoofdtekst van de aanvraag is een JSON-matrix. Elk matrixelement is een JSON-object met een tekenreekseigenschap met de naam Text, die de tekenreeks vertegenwoordigt die moet worden geconverteerd.

[
    {"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.

Voorbeeld van JSON-antwoord:

[
  {
    "text": "Kon'nichiwa",
    "script": "Latn"
  },
  {
    "text": "sayonara",
    "script": "Latn"
  }
]

Notitie

Elk voorbeeld wordt uitgevoerd op de localhost opdracht die u hebt docker run opgegeven.
Terwijl uw container wordt uitgevoerd, localhost verwijst u naar de container zelf.
Je hoeft niet te gebruiken localhost:5000. U kunt elke poort gebruiken die nog niet in gebruik is in uw hostomgeving.

Transliteratie met REST API


  curl -X POST "http://localhost:5000/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn" -H "Content-Type: application/json" -d "[{'Text':'こんにちは'},{'Text':'さようなら'}]"

Volgende stappen

Meer informatie over transliteratie van tekst

Delen via