Ondersteunde woordenlijstindelingen ophalen

  • Artikel

Reference
Service: Azure AI Document Translation
API Version: v1.1

De methode Ondersteunde woordenlijstindelingen ophalen retourneert een lijst met woordenlijstindelingen die worden ondersteund door de service Documentvertaling. De lijst bevat de algemene bestandsextensie die wordt gebruikt.

Aanvraag-URL

Een aanvraag GET versturen naar:

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

Meer informatie over het vinden van uw aangepaste domeinnaam.

Belangrijk

  • Voor alle API-aanvragen voor de documentomzettingsservice is een aangepast domeineindpunt vereist.
  • U kunt het eindpunt dat is gevonden op de azure-portal-resourcesleutels en -eindpunten en het globale translator-eindpuntapi.cognitive.microsofttranslator.com, niet gebruiken om HTTP-aanvragen te maken voor documentomzetting.

Aanvraagheaders

Aanvraagheaders zijn:

Kopteksten Beschrijving
Ocp-Apim-Subscription-Key Vereiste aanvraagheader

Antwoordstatuscodes

Hier volgen de mogelijke HTTP-statuscodes die een aanvraag retourneert.

Statuscode Beschrijving
200 OK. Retourneert de lijst met ondersteunde woordenlijstbestandsindelingen.
500 Interne serverfout.
Overige statuscodes • Te veel aanvragen
• Server tijdelijk niet beschikbaar

Antwoord van ondersteunde woordenlijstindelingen ophalen

Basistype voor lijst retourneren in de API voor ondersteunde woordenlijstindelingen ophalen.

Geslaagde weergave van ondersteunde woordenlijstindelingen

Basistype voor lijst retourneren in de API voor ondersteunde woordenlijstindelingen ophalen.

Name Type Description
waarde FileFormat [] FileFormat[] bevat de vermelde details.
value.contentTypes tekenreeks [] Ondersteunde inhoudstypen voor deze indeling.
value.defaultVersion tekenreeks Standaardversie als er geen is opgegeven
value.fileExtensions tekenreeks [] Ondersteunde bestandsextensie voor deze indeling.
value.format tekenreeks Naam van de notatie.
value.versions tekenreeks [] Ondersteunde versie.

Foutrespons

Name Type Description
code tekenreeks Opsommingen met foutcodes op hoog niveau. Mogelijke waarden:
• InternalServerError
• InvalidArgument
• InvalidRequest
• RequestRateTooHigh
• ResourceNotFound
• ServiceUnavailable
•Onbevoegde
bericht tekenreeks Hiermee wordt een foutbericht op hoog niveau weergegeven.
innerError InnerTranslationError Nieuwe interne foutindeling die voldoet aan api-richtlijnen voor Azure AI-services. Dit foutbericht bevat vereiste eigenschappen ErrorCode, bericht en optionele eigenschappendoel, details (sleutelwaardepaar), interne fout (deze kan worden genest).
innerError.code tekenreeks Hiermee haalt u de codefoutreeks op.
innerError.message tekenreeks Hiermee wordt een foutbericht op hoog niveau weergegeven.
innerError.target tekenreeks Hiermee haalt u de bron van de fout op. Dit kan bijvoorbeeld het zijn documents of document id als er een ongeldig document is.

Voorbeelden

Voorbeeld van geslaagde reactie

Het volgende JSON-object is een voorbeeld van een geslaagd antwoord.

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

Voorbeeld van een foutbericht

Het volgende JSON-object is een voorbeeld van een foutreactie. Het schema voor andere foutcodes is hetzelfde.

Statuscode: 500

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

Volgende stappen

Volg onze quickstart voor meer informatie over het gebruik van documentomzetting en de clientbibliotheek.

Aan de slag met de documentvertaling