Ondersteunde woordenlijstindelingen krijgen

De methode Ondersteunde woordenlijstindelingen krijgen retourneert een lijst met woordenlijstindelingen die worden ondersteund door de documentvertalingsservice. De lijst bevat de gebruikte algemene bestandsextensie.

Aanvraag-URL

Verzend een GET aanvraag naar:

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

Meer informatie over het vinden van uw aangepaste domeinnaam.

Belangrijk

  • Voor alle API-aanvragen voor de documentvertalingsservice is een aangepast domein-eindpunt vereist.
  • U kunt het eindpunt op de pagina sleutels en eindpunt van uw Azure Portal-resource, noch het globale translator-eindpunt, , gebruiken om HTTP-aanvragen voor documentvertaling api.cognitive.microsofttranslator.com te maken.

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.
Andere statuscodes
  • Te veel aanvragen
  • Server tijdelijk niet beschikbaar

Antwoord van ondersteunde woordenlijstindelingen

Basistype voor lijst retourneert in de API Ondersteunde woordenlijstindelingen krijgen.

Geslaagd antwoord op ondersteunde woordenlijstindelingen

Basistype voor lijst retourneert in de API Ondersteunde woordenlijstindelingen krijgen.

Naam Type Beschrijving
waarde FileFormat [] FileFormat[] bevat de hieronder 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 indeling.
value.versions tekenreeks [] Ondersteunde versie.

Foutbericht

Naam Type Beschrijving
code tekenreeks Enums met foutcodes op hoog niveau. Mogelijke waarden:
  • InternalServerError
  • InvalidArgument
  • InvalidRequest
  • RequestRateTooHigh
  • ResourceNotFound
  • ServiceUnavailable
  • Niet geautoriseerd
message tekenreeks Haalt een foutbericht op hoog niveau op.
innerError InnerTranslationError Nieuwe interne foutindeling die voldoet aan Cognitive Services API-richtlijnen. Dit bevat de vereiste eigenschappen ErrorCode, message en optional properties target, details(sleutel-waardepaar), interne fout (dit kan worden genest).
innerError.code tekenreeks Haalt een codefoutreeks op.
innerError.message tekenreeks Haalt een foutbericht op hoog niveau op.
innerError.target tekenreeks Haalt de bron van de fout op. Dit zijn bijvoorbeeld 'documenten' of 'document-id' in het geval van een ongeldig document.

Voorbeelden

Voorbeeld van een geslaagd antwoord

Hier volgt 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 is een voorbeeld van een foutbericht. 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 Documentvertaling en de clientbibliotheek.