Támogatott szószedetformátumok lekérése

Referenciafunkció: Azure AI Translator → Document Translation
API-verzió: 2024-05-01
HTTP-módszer: GET

Ez a metódus a Dokumentumfordítás funkció által támogatott szószedetformátumok listáját adja vissza. A lista tartalmazza a gyakori fájlkiterjesztéseket.

URL-cím kérése

Fontos

A Dokumentumfordítás szolgáltatáshoz érkező összes API-kéréshez egyéni tartományvégpont szükséges, amely az Azure Portal erőforrás-áttekintési oldalán található.

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

Kérésfejlécek

A kérelemfejlécek a következők:

Fejlécek	Leírás	Feltétel
Ocp-Apim-Subscription-Key	A Translator szolgáltatás API-kulcsa az Azure Portalról.	Szükséges
Ocp-Apim-Subscription-Region	Az a régió, ahol az erőforrás létre lett hozva.	Olyan regionális (földrajzi) erőforrás használatakor szükséges , mint az USA nyugati régiója. >listajel.
Tartalomtípus	A hasznos adat tartalomtípusa. Az elfogadott érték az application/json vagy charset=UTF-8.	Szükséges

Válaszállapot-kódok

A következő lehetséges HTTP-állapotkódokat adja vissza egy kérés.

Állapotkód	Leírás
200	OK. A támogatott szószedetfájl-formátumok listáját adja vissza.
500	Belső kiszolgálóhiba.
Egyéb állapotkódok	• Túl sok kérés • A kiszolgáló ideiglenesen nem érhető el

Támogatott szószedetformátumok válaszának lekérése

A lista alaptípusa a támogatott szószedetformátumok lekérése API-ban tér vissza.

Támogatott szószedetformátumok sikeres lekérése válasz

A lista alaptípusa a támogatott szószedetformátumok lekérése API-ban tér vissza.

Név	Típus	Leírás
Érték	FileFormat []	A FileFormat[] a felsorolt adatokat tartalmazza.
value.contentTypes	sztring []	Támogatott tartalomtípusok ehhez a formátumhoz.
value.defaultVersion	húr	Alapértelmezett verzió, ha nincs megadva
value.fileExtensions	sztring []	Ehhez a formátumhoz támogatott fájlkiterjesztés.
value.format	húr	A formátum neve.
value.versions	sztring []	Támogatott verzió.

Hibaválasz

Név	Típus	Leírás
code	húr	Magas szintű hibakódokat tartalmazó enumerálások. Lehetséges értékek: • InternalServerError • InvalidArgument • InvalidRequest • RequestRateTooHigh • ResourceNotFound • ServiceUnavailable •Illetéktelen
üzenet	húr	Magas szintű hibaüzenetet kap.
innerError	InnerTranslationError	Új belső hibaformátum, amely megfelel az Azure AI-szolgáltatások API-irányelveinek. Ez a hibaüzenet tartalmazza a szükséges tulajdonságokat: ErrorCode, üzenet és opcionális tulajdonságcél, részletek (kulcsértékpár), belső hiba (beágyazható).
innerError.code	húr	Kódhiba sztringet kap.
innerError.message	húr	Magas szintű hibaüzenetet kap.
innerError.target	húr	Lekéri a hiba forrását. Például az lenne documents , vagy document id ha érvénytelen dokumentum lenne.

Példák

Példa a sikeres válaszra

A következő JSON-objektum egy sikeres válasz példája.

{
    "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"
            ]
        }
    ]
}

Példa hibaválaszra

Az alábbi JSON-objektum egy példa egy hibaválaszra. A többi hibakód sémája ugyanaz.

Állapotkód: 500

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

Következő lépések

A dokumentumfordítás és az ügyféloldali kódtár használatával kapcsolatos további információkért kövesse a rövid útmutatót.

Ismerkedés a dokumentumfordítással