Desteklenen belge biçimlerini alma

Desteklenen belge biçimlerini al yöntemi, Belge Çevirisi hizmeti tarafından desteklenen belge biçimlerinin listesini döndürür. Liste ortak dosya uzantısını ve karşıya yükleme API'sini kullanıyorsanız içerik türünü içerir.

İstek URL’si

Şu kişilere istek GET gönderin:

GET https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.0/documents/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 Description
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 Description
200 Tamam ögesini seçin. Desteklenen belge dosyası biçimlerinin listesini döndürür.
500 İç Sunucu Hatası.
Diğer Durum Kodları
  • Çok fazla istek var
  • Sunucu geçici kullanılamıyor

Dosya biçimi yanıtı

Başarılı fileFormatListResult yanıtı

Başarılı bir yanıtta aşağıdaki bilgiler döndürülür.

Ad Tür Description
değer Dosya Biçimi [] FileFormat[] aşağıda listelenen ayrıntıları içerir.
value.contentTypes string[] Bu biçim için desteklenen İçerik Türleri.
value.defaultVersion string Belirtilmemişse varsayılan sürüm.
value.fileExtensions string[] Bu biçim için desteklenen dosya uzantısı.
value.format string Biçimin adı.
value.versions dize [] Desteklenen sürüm.

Hata yanıtı

Ad Tür Description
kod string Üst düzey hata kodları içeren sabit listeleri. Olası değerler:
  • InternalServerError
  • InvalidArgument
  • InvalidRequest
  • RequestRateTooHigh
  • ResourceNotFound
  • ServiceUnavailable
  • Yetkisiz
message string Üst düzey hata iletisi alır.
innerError InnerTranslationError Bilişsel Hizmetler API Yönergeleri'ne uyan yeni İç Hata biçimi. Bu, 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 string Kod hata dizesini alır.
innerError.message string Üst düzey hata iletisi alır.
innerError.target string Hatanın kaynağını alır. Örneğin, geçersiz belge olması durumunda "belgeler" veya "belge kimliği" olabilir.

Örnekler

Örnek başarılı yanıt

Aşağıda başarılı bir yanıt örneği verilmiştir.

Durum kodu: 200

{
    "value": [
        {
            "format": "PlainText",
            "fileExtensions": [
                ".txt"
            ],
            "contentTypes": [
                "text/plain"
            ],
            "versions": []
        },
        {
            "format": "OpenXmlWord",
            "fileExtensions": [
                ".docx"
            ],
            "contentTypes": [
                "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
            ],
            "versions": []
        },
        {
            "format": "OpenXmlPresentation",
            "fileExtensions": [
                ".pptx"
            ],
            "contentTypes": [
                "application/vnd.openxmlformats-officedocument.presentationml.presentation"
            ],
            "versions": []
        },
        {
            "format": "OpenXmlSpreadsheet",
            "fileExtensions": [
                ".xlsx"
            ],
            "contentTypes": [
                "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
            ],
            "versions": []
        },
        {
            "format": "OutlookMailMessage",
            "fileExtensions": [
                ".msg"
            ],
            "contentTypes": [
                "application/vnd.ms-outlook"
            ],
            "versions": []
        },
        {
            "format": "HtmlFile",
            "fileExtensions": [
                ".html",
                ".htm"
            ],
            "contentTypes": [
                "text/html"
            ],
            "versions": []
        },
        {
            "format": "PortableDocumentFormat",
            "fileExtensions": [
                ".pdf"
            ],
            "contentTypes": [
                "application/pdf"
            ],
            "versions": []
        },
        {
            "format": "XLIFF",
            "fileExtensions": [
                ".xlf"
            ],
            "contentTypes": [
                "application/xliff+xml"
            ],
            "versions": [
                "1.0",
                "1.1",
                "1.2"
            ]
        },
        {
            "format": "TSV",
            "fileExtensions": [
                ".tsv",
                ".tab"
            ],
            "contentTypes": [
                "text/tab-separated-values"
            ],
            "versions": []
        },
        {
            "format": "CSV",
            "fileExtensions": [
                ".csv"
            ],
            "contentTypes": [
                "text/csv"
            ],
            "versions": []
        },
        {
            "format": "RichTextFormat",
            "fileExtensions": [
                ".rtf"
            ],
            "contentTypes": [
                "application/rtf"
            ],
            "versions": []
        },
        {
            "format": "WordDocument",
            "fileExtensions": [
                ".doc"
            ],
            "contentTypes": [
                "application/msword"
            ],
            "versions": []
        },
        {
            "format": "PowerpointPresentation",
            "fileExtensions": [
                ".ppt"
            ],
            "contentTypes": [
                "application/vnd.ms-powerpoint"
            ],
            "versions": []
        },
        {
            "format": "ExcelSpreadsheet",
            "fileExtensions": [
                ".xls"
            ],
            "contentTypes": [
                "application/vnd.ms-excel"
            ],
            "versions": []
        },
        {
            "format": "OpenDocumentText",
            "fileExtensions": [
                ".odt"
            ],
            "contentTypes": [
                "application/vnd.oasis.opendocument.text"
            ],
            "versions": []
        },
        {
            "format": "OpenDocumentPresentation",
            "fileExtensions": [
                ".odp"
            ],
            "contentTypes": [
                "application/vnd.oasis.opendocument.presentation"
            ],
            "versions": []
        },
        {
            "format": "OpenDocumentSpreadsheet",
            "fileExtensions": [
                ".ods"
            ],
            "contentTypes": [
                "application/vnd.oasis.opendocument.spreadsheet"
            ],
            "versions": []
        },
        {
            "format": "Markdown",
            "fileExtensions": [
                ".markdown",
                ".mdown",
                ".mkdn",
                ".md",
                ".mkd",
                ".mdwn",
                ".mdtxt",
                ".mdtext",
                ".rmd"
            ],
            "contentTypes": [
                "text/markdown",
                "text/x-markdown",
                "text/plain"
            ],
            "versions": []
        },
        {
            "format": "Mhtml",
            "fileExtensions": [
                ".mhtml",
                ".mht"
            ],
            "contentTypes": [
                "message/rfc822",
                "application/x-mimearchive",
                "multipart/related"
            ],
            "versions": []
        }
    ]
}

Örnek hata yanıtı

Aşağıda bir hata yanıtı örneği verilmiştir. Diğer hata kodları için şema 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.