Translator 3.0: Algılama

Metin parçasının dilini tanımlar.

İstek URL’si

Şuraya bir POST isteği gönderin:

https://api.cognitive.microsofttranslator.com/detect?api-version=3.0

Bkz. Sanal Ağ Translator hizmeti için destek seçili ağ ve özel uç nokta yapılandırması ve desteği.

İstek parametreleri

Sorgu dizesinde geçirilen istek parametreleri şunlardır:

Sorgu parametresi	Açıklama
api-sürümü	Gerekli parametre. İstemci tarafından istenen API sürümü. Değer olmalıdır 3.0.

İstek üst bilgileri şunlardır:

Üst Bilgiler	Description
Kimlik doğrulama üst bilgileri	Gerekli istek üst bilgisi. Kimlik doğrulaması için kullanılabilir seçeneklere bakın.
İçerik Türü	Gerekli istek üst bilgisi. Yükün içerik türünü belirtir. Olası değerler şunlardır: application/json.
İçerik Uzunluğu	Gerekli istek üst bilgisi. İstek gövdesinin uzunluğu.
X-ClientTraceId	İsteğe bağlı. İsteği benzersiz olarak tanımlamak için istemci tarafından oluşturulan GUID. adlı ClientTraceIdbir sorgu parametresi kullanarak izleme kimliğini sorgu dizesine eklerseniz bu üst bilgiyi atlayabilirsiniz.

İstek gövdesi

İsteğin gövdesi bir JSON dizisidir. Her dizi öğesi adlı Textdize özelliğine sahip bir JSON nesnesidir. Dil algılama özelliğin Text değerine uygulanır. Dil otomatik algılama, daha uzun giriş metniyle daha iyi çalışır. Örnek istek gövdesi şöyle görünür:

[
    { "Text": "Ich würde wirklich gerne Ihr Auto ein paar Mal um den Block fahren." }
]

Aşağıdaki sınırlamalar geçerlidir:

• Dizide en fazla 100 öğe olabilir.
• İstekte yer alan metnin tamamı boşluklar dahil 50.000 karakteri aşamaz.

Yanıt gövdesi

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

• language: Algılanan dilin kodu.

• score: Sonuçtaki güveni gösteren bir float değeri. Puan sıfır ile bir arasında ve düşük puan düşük güveni gösterir.

• isTranslationSupported: Algılanan dil metin çevirisi için desteklenen dillerden biriyse true olan boole değeri.

• isTransliterationSupported: Algılanan dil, alfabeye çevirme için desteklenen dillerden biriyse true olan boole değeri.

• alternatives: Diğer olası dillerden oluşan bir dizi. Dizinin her öğesi, şu özelliklere sahip başka bir nesnedir: language, isTranslationSupportedscoreve isTransliterationSupported.

Örnek bir JSON yanıtı:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

Yanıt üst bilgileri

Üst Bilgiler	Description
X-RequestId	İsteği tanımlamak için hizmet tarafından oluşturulan değer. Sorun giderme amacıyla kullanılır.

Yanıt durum kodları

Bir isteğin döndürdüğü olası HTTP durum kodları aşağıdadır.

Durum Kodu	Description
200	Başarılı.
400	Sorgu parametrelerinden biri eksik veya geçersiz. Yeniden denemeden önce doğru istek parametreleri.
401	İsteğin kimliği doğrulanamadı. Kimlik bilgilerinin belirtildiğini ve geçerli olduğunu denetleyin.
403	İstek yetkilendirilmedi. Ayrıntılar hata iletisini denetleyin. Bu kod genellikle bir deneme aboneliğiyle sağlanan tüm ücretsiz çevirilerin kullanıldığını gösterir.
429	İstemci istek sınırlarını aştığı için sunucu isteği reddetti.
500	Beklenmeyen bir hata oluştu. Hata devam ederse şunu bildirin: hatanın tarihi ve saati, yanıt üst bilgisinden istek tanımlayıcısı ve istek üst bilgisinden X-RequestIdX-ClientTraceIdistemci tanımlayıcısı.
503	Sunucu geçici olarak kullanılamıyor. İsteği yeniden deneyin. Hata devam ederse şunu bildirin: hatanın tarihi ve saati, yanıt üst bilgisinden istek tanımlayıcısı ve istek üst bilgisinden X-RequestIdX-ClientTraceIdistemci tanımlayıcısı.

Hata oluşursa istek bir JSON hata yanıtı döndürür. Hata kodu, hatayı daha fazla kategorilere ayırmak için 3 basamaklı HTTP durum kodunu ve ardından 3 basamaklı bir sayıyı birleştiren 6 basamaklı bir sayıdır. Yaygın hata kodları v3 Çevirmen başvuru sayfasında bulunabilir.

Örnekler

Aşağıdaki örnekte, metin çevirisi için desteklenen dillerin nasıl alınıyor olduğu gösterilmektedir.

curl -X POST "https://api.cognitive.microsofttranslator.com/detect?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'What language is this text written in?'}]"