Desteklenen sözlük biçimlerini alma

Makale
09/01/2024

Başvuru
Özelliği: Azure AI Translator → Belge Çevirisi
API'si Sürümü: 2024-05-01
HTTP yöntemi: GET

Bu yöntem, Belge Çevirisi özelliği tarafından desteklenen sözlük biçimlerinin listesini döndürür. Liste ortak dosya uzantılarını içerir.

İstek URL’si

Önemli

Belge Çevirisi özelliğine yönelik tüm API istekleri, Azure portalındaki kaynağınıza genel bakış sayfasında bulunan özel bir etki alanı uç noktası gerektirir.

curl -i -X GET "{document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary"

İstek üst bilgileri

İstek üst bilgileri şunlardır:

Üst Bilgiler	Açıklama	Koşul
Ocp-Apim-Subscription-Key	Azure portalından Translator hizmeti API anahtarınız.	Required
Ocp-Apim-Subscription-Region	Kaynağınızın oluşturulduğu bölge.	Batı ABD gibi bölgesel (coğrafi) bir kaynak kullanılırken gereklidir. & madde işareti.
İçerik Türü	Yükün içerik türü. Kabul edilen değer application/json veya charset=UTF-8'dir.	Required

Yanıt durum kodları

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

Durum Kodu	Açıklama
200	Tamam. Desteklenen sözlük dosyası biçimlerinin listesini döndürür.
500	İç Sunucu Hatası.
Diğer Durum Kodları	• Çok fazla istek • Sunucu geçici olarak kullanılamıyor

Desteklenen sözlük biçimleri yanıtı alma

Desteklenen sözlük biçimleri al API'sinde liste dönüşü için temel tür.

Başarılı desteklenen sözlük biçimleri yanıtı alma

Desteklenen sözlük biçimleri al API'sinde liste dönüşü için temel tür.

Adı	Tür	Açıklama
değer	Dosya Biçimi []	FileFormat[] listelenen ayrıntıları içerir.
value.contentTypes	dize []	Bu biçim için desteklenen İçerik Türleri.
value.defaultVersion	Dize	Hiçbiri belirtilmezse varsayılan sürüm
value.fileExtensions	dize []	Bu biçim için desteklenen dosya uzantısı.
value.format	Dize	Biçimin adı.
value.versions	dize []	Desteklenen sürüm.

Hata yanıtı

Adı	Tür	Açıklama
kod	Dize	Üst düzey hata kodları içeren sabit listeleri. Olası değerler: • InternalServerError • InvalidArgument • InvalidRequest • RequestRateTooHigh • ResourceNotFound • ServiceUnavailable •Yetkisiz
ileti	Dize	Üst düzey hata iletisi alır.
innerError	InnerTranslationError	Azure AI hizmetleri API Yönergelerine uygun yeni İç Hata biçimi. Bu hata iletisi gerekli ErrorCode, ileti ve isteğe bağlı özellik hedefi, ayrıntılar (anahtar değer çifti), iç hata (iç içe olabilir) özelliklerini içerir.
innerError.code	Dize	Kod hata dizesini alır.
innerError.message	Dize	Üst düzey hata iletisi alır.
innerError.target	Dize	Hatanın kaynağını alır. Örneğin, `documents` `document id` veya geçersiz bir belge varsa olabilir.

Örnekler

Örnek başarılı yanıt

Aşağıdaki JSON nesnesi başarılı bir yanıt örneğidir.

{
    "value": [
        {
            "format": "XLIFF",
            "fileExtensions": [
                ".xlf"
            ],
            "contentTypes": [
                "application/xliff+xml"
            ],
            "defaultVersion": "1.2",
            "versions": [
                "1.0",
                "1.1",
                "1.2"
            ]
        },
        {
            "format": "TSV",
            "fileExtensions": [
                ".tsv",
                ".tab"
            ],
            "contentTypes": [
                "text/tab-separated-values"
            ]
        },
        {
            "format": "CSV",
            "fileExtensions": [
                ".csv"
            ],
            "contentTypes": [
                "text/csv"
            ]
        }
    ]
}

Örnek hata yanıtı

Aşağıdaki JSON nesnesi bir hata yanıtı örneğidir. Diğer hata kodlarının şeması aynıdır.

Durum kodu: 500

{
  "error": {
    "code": "InternalServerError",
    "message": "Internal Server Error",
    "innerError": {
      "code": "InternalServerError",
      "message": "Unexpected internal server error has occurred"
    }
  }
}

Sonraki adımlar

Belge Çevirisi ve istemci kitaplığını kullanma hakkında daha fazla bilgi edinmek için hızlı başlangıcımızı izleyin.

Belge Çevirisi ile çalışmaya başlama

Aracılığıyla paylaş