Delen via


Translator - Transliterate

Hiermee wordt de tekst van een taal in het ene schrift geconverteerd naar een ander type schrift. Voorbeeld: Japans schrift "こんにちは" Hetzelfde woord in het Latijnse schrift "konnichiha"

POST {Endpoint}/transliterate?api-version=3.0&language={language}&fromScript={fromScript}&toScript={toScript}

URI-parameters

Name In Vereist Type Description
Endpoint
path True

string

Ondersteunde Cognitive Services-eindpunten

api-version
query True

string

Versie van de API die door de client is aangevraagd. Waarde moet 3,0 zijn.

fromScript
query True

string

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.

language
query True

string

Hiermee geeft u de taal van de tekst die van het ene script naar het andere moet worden geconverteerd. Mogelijke talen worden vermeld in het transliteration bereik dat wordt verkregen door de service op te vragen voor de ondersteunde talen.

toScript
query True

string

Hiermee geeft u het uitvoerscript. 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.

Aanvraagkoptekst

Name Vereist Type Description
X-ClientTraceId

string

Een door de client gegenereerde GUID om de aanvraag uniek te identificeren. Houd er rekening mee dat u deze koptekst kunt weglaten als u de tracerings-id in de querytekenreeks opneemt met behulp van een queryparameter met de naam ClientTraceId.

Aanvraagbody

Name Type Description
texts

TransliterateTextInput[]

Inhoud van het verzoek

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. De volgende beperkingen zijn van toepassing:

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

Antwoordlichaam

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

Antwoorden

Name Type Description
200 OK

TransliterateResult[]

Geslaagd

Other Status Codes

ErrorMessage

Foutreactie.

Beveiliging

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Ocp-Apim-Subscription-Region

Type: apiKey
In: header

Voorbeelden

Transliterate success example

Voorbeeldaanvraag

POST https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0&language=ja&fromScript=jpan&toScript=latn

Voorbeeldrespons

[
  {
    "text": "sodeska",
    "script": "latn"
  }
]

Definities

Name Description
Error
ErrorMessage
TransliterateResult

Voorbeeld van een succesvolle transliteratieaanvraag

TransliterateTextInput

Tekst die nodig is voor een transliteratieverzoek

Error

Name Type Description
code

string

message

string

ErrorMessage

Name Type Description
error

Error

TransliterateResult

Voorbeeld van een succesvolle transliteratieaanvraag

Name Type Description
script

string

text

string

TransliterateTextInput

Tekst die nodig is voor een transliteratieverzoek

Name Type Description
text

string