Hämta ordlisteformat som stöds

  • Artikel

Referenstjänst
: Azure AI Document Translation
API-version: v1.1

Metoden Hämta ordlisteformat som stöds returnerar en lista över ordlisteformat som stöds av dokumentöversättningstjänsten. Listan innehåller det vanliga filnamnstillägget som används.

Begärans-URL

Skicka en GET-begäran till:

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

Lär dig hur du hittar ditt anpassade domännamn.

Viktigt!

  • Alla API-begäranden till dokumentöversättningstjänsten kräver en anpassad domänslutpunkt.
  • Du kan inte använda slutpunkten som finns på azure-portalens resursnycklar och slutpunktssida eller den globala translator-slutpunkten –api.cognitive.microsofttranslator.com för att göra HTTP-begäranden till dokumentöversättning.

Begärandehuvuden

Begärandehuvuden är:

Sidhuvuden beskrivning
Ocp-Apim-Subscription-Key Obligatoriskt begärandehuvud

Svarsstatuskoder

Följande är de möjliga HTTP-statuskoder som en begäran returnerar.

Statuskod beskrivning
200 OK. Returnerar listan över ordlistefilformat som stöds.
500 Internt serverfel.
Andra statuskoder • För många förfrågningar
• Servern är tillfälligt otillgänglig

Få svar på ordlisteformat som stöds

Bastyp för listretur i API:et Hämta ordlisteformat som stöds.

Svar om ordlisteformat som stöds har lyckats

Bastyp för listretur i API:et Hämta ordlisteformat som stöds.

Namn Type Beskrivning
värde FileFormat [] FileFormat[] innehåller den angivna informationen.
value.contentTypes sträng [] Innehållstyper som stöds för det här formatet.
value.defaultVersion sträng Standardversion om ingen har angetts
value.fileExtensions sträng [] Filnamnstillägg som stöds för det här formatet.
value.format sträng Namnet på formatet.
value.versions sträng [] Version som stöds.

Felsvar

Namn Type Beskrivning
kod sträng Uppräkningar som innehåller felkoder på hög nivå. Möjliga värden:
• InternalServerError
• InvalidArgument
• InvalidRequest
• RequestRateTooHigh
• ResourceNotFound
• ServiceUnavailable
•Obehörig
meddelande sträng Hämtar felmeddelande på hög nivå.
innerError InnerTranslationError Nytt format för inre fel som överensstämmer med API-riktlinjerna för Azure AI-tjänster. Det här felmeddelandet innehåller nödvändiga egenskaper ErrorCode, meddelande och valfria egenskaper mål, information (nyckel/värde-par), inre fel (det kan kapslas).
innerError.code sträng Hämtar kodfelsträngen.
innerError.message sträng Hämtar felmeddelande på hög nivå.
innerError.target sträng Hämtar källan till felet. Det skulle till exempel vara documents eller document id om det fanns ett ogiltigt dokument.

Exempel

Exempel på lyckat svar

Följande JSON-objekt är ett exempel på ett lyckat svar.

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

Exempel på felsvar

Följande JSON-objekt är ett exempel på ett felsvar. Schemat för andra felkoder är detsamma.

Statuskod: 500

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

Nästa steg

Följ vår snabbstart om du vill veta mer om hur du använder dokumentöversättning och klientbiblioteket.

Kom igång med dokumentöversättning