Aracılığıyla paylaş


Translator - Transliterate

Bir alfabedeki dil metnini başka bir alfabe türüne dönüştürür. Örnek- Japon alfabesi "こんにちは" Latin alfabesiyle aynı kelime "konnichiha"

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

URI Parametreleri

Name İçinde Gerekli Tür Description
Endpoint
path True

string

Desteklenen Bilişsel Hizmetler uç noktaları

api-version
query True

string

İstemci tarafından istenen API sürümü. Değer 3.0 olmalıdır.

fromScript
query True

string

Giriş metni tarafından kullanılan betiği belirtir. Seçilen dil için kullanılabilir giriş komut dosyalarını bulmak için kapsamı kullanarak transliteration desteklenen dilleri arayın.

language
query True

string

Bir betikten diğerine dönüştürülecek metnin dilini belirtir. Olası diller, hizmetin desteklediği diller için sorgulanarak elde edilen kapsamda listelenir transliteration .

toScript
query True

string

Çıkış betiğini belirtir. Seçilen giriş dili ve giriş betiği kombinasyonu için kullanılabilir çıkış betiklerini bulmak için kapsamı kullanarak transliteration desteklenen dilleri arayın.

İstek Başlığı

Name Gerekli Tür Description
X-ClientTraceId

string

İsteği benzersiz olarak tanımlamak için istemci tarafından oluşturulan GUID. ClientTraceId adlı bir sorgu parametresi kullanarak sorgu dizesine izleme kimliğini eklerseniz bu üst bilgiyi atlayabileceğinizi unutmayın.

İstek Gövdesi

Name Tür Description
texts

TransliterateTextInput[]

İstek içeriği

İsteğin gövdesi bir JSON dizisidir. Her dizi öğesi, dönüştürülecek dizeyi temsil eden adlı Textdize özelliğine sahip bir JSON nesnesidir. Aşağıdaki sınırlamalar geçerlidir:

  • Dizide en fazla 10 öğe olabilir.
  • Bir dizi öğesinin metin değeri, boşluklar dahil olmak üzere 1.000 karakteri aşamaz.
  • İstekte yer alan metnin tamamı, boşluklar dahil olmak üzere 5.000 karakteri aşamaz.

Yanıtın içeriği

Başarılı bir yanıt, giriş dizisindeki her öğe için bir sonuç içeren bir JSON dizisidir. Sonuç nesnesi aşağıdaki özellikleri içerir:

  • text- Giriş dizesini çıkış komut dosyasına dönüştürmenin sonucu olan bir dize.
  • script- Çıktıda kullanılan betiği belirten bir dize.

Yanıtlar

Name Tür Description
200 OK

TransliterateResult[]

Başarı

Other Status Codes

ErrorMessage

Hata yanıtı.

Güvenlik

Ocp-Apim-Subscription-Key

Tür: apiKey
İçinde: header

Ocp-Apim-Subscription-Key

Tür: apiKey
İçinde: header

Ocp-Apim-Subscription-Region

Tür: apiKey
İçinde: header

Örnekler

Transliterate success example

Örnek isteği

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

Örnek yanıt

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

Tanımlar

Name Description
Error
ErrorMessage
TransliterateResult

Başarılı bir harf çevirisi isteği örneği

TransliterateTextInput

Harf çevirisi isteği için gereken metin

Error

Name Tür Description
code

string

message

string

ErrorMessage

Name Tür Description
error

Error

TransliterateResult

Başarılı bir harf çevirisi isteği örneği

Name Tür Description
script

string

text

string

TransliterateTextInput

Harf çevirisi isteği için gereken metin

Name Tür Description
text

string