Translator 3.0: Algıla
Bir 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
İ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:
Request body
İsteğin gövdesi bir JSON dizisidir. Her dizi öğesi adlı Text
dize özelliğine sahip bir JSON nesnesidir. Dil algılama özelliğin değerine Text
uygulanır. Dil otomatik denetimi, 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 da dahil olmak üzere 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 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, ayrıştırma 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
,score
,isTranslationSupported
veisTransliterationSupported
.
Örnek bir JSON yanıtı:
[
{
"language": "de",
"score": 1.0,
"isTranslationSupported": true,
"isTransliterationSupported": false
}
]
Yanıt üst bilgileri
Üst Bilgiler | Açıklama |
---|---|
X-RequestId | hizmet tarafından isteği tanımlamak için oluşturulan ve sorun giderme amacıyla kullanılan değer. |
Yanıt durum kodları
Bir isteğin döndürdüğü olası HTTP durum kodları aşağıdadır.
Durum Kodu | Açıklama |
---|---|
200 | Başarılı. |
400 | Sorgu parametrelerinden biri eksik veya geçersiz. Yeniden denemeden önce istek parametrelerini düzeltin. |
Kategori 401 | İsteğin kimliği doğrulanamadı. Kimlik bilgilerinin belirtildiğini ve geçerli olduğunu denetleyin. |
Kategori 403 | İstek yetkilendirilmedi. Ayrıntılar hata iletisini denetleyin. Bu kod genellikle deneme aboneliğiyle sağlanan tüm ücretsiz çevirilerin kullanıldığını gösterir. |
Kategori 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-RequestId istemci tanımlayıcısı X-ClientTraceId . |
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-RequestId istemci tanımlayıcısı X-ClientTraceId . |
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?'}]"