Desteklenen sözlük biçimlerini alma

  • Makale

Başvuru
Hizmeti: Azure AI Belge Çevirisi
API Sürümü: v1.1

Desteklenen sözlük biçimleri al yöntemi, Belge Çevirisi hizmeti tarafından desteklenen sözlük biçimlerinin listesini döndürür. Liste, kullanılan ortak dosya uzantısını içerir.

İstek URL’si

Şuraya bir GET isteği gönderin:

GET https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats

Özel etki alanı adınızı bulmayı öğrenin.

Önemli

  • Belge Çevirisi hizmetine yönelik tüm API istekleri için özel bir etki alanı uç noktası gerekir.
  • Belge Çevirisi'ne HTTP isteklerinde bulunmak için Azure portalı kaynak Anahtarlar ve Uç Nokta sayfanızda bulunan uç noktayı veya genel çeviri uç noktasınıapi.cognitive.microsofttranslator.com kullanamazsınız.

İstek üst bilgileri

İstek üst bilgileri şunlardır:

Üst Bilgiler Açıklama
Ocp-Apim-Subscription-Key Gerekli istek üst bilgisi

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
•Yetki -siz
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, documentsdocument 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