Ottenere i formati di glossario supportati

Articolo
06/01/2024

Funzionalità di riferimento
: Azure AI Traduttore → versione dell'API Traduzione
documenti: metodo HTTP 2024-05-01
: GET

Questo metodo restituisce un elenco di formati di glossario supportati dalla funzionalità Traduzione documenti. L'elenco include le estensioni di file comuni.

Richiesta URL

Importante

Tutte le richieste API alla funzionalità Traduzione documenti richiedono un endpoint di dominio personalizzato che si trova nella pagina di panoramica delle risorse nella portale di Azure.

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

Intestazioni delle richieste

Le intestazioni della richiesta sono le seguenti:

Intestazioni	Descrizione	Condizione
Ocp-Apim-Subscription-Key	La chiave API del servizio Traduttore dal portale di Azure.	Richiesto
Ocp-Apim-Subscription-Region	Area in cui è stata creata la risorsa.	• Obbligatorio quando si usa una risorsa regionale (geografica) come Stati Uniti occidentali. &bullet.
Content-Type	Tipo di contenuto del payload. Il valore accettato è application/json o charset=UTF-8.	• Obbligatorio

Codici di stato della risposta

Di seguito sono riportati i possibili codici di stato HTTP restituiti da una richiesta.

Codice di stato	Descrizione
200	OK. Restituisce l'elenco dei formati di file di glossario supportati.
500	Errore interno del server.
Altri codici di stato	• Troppe richieste • Server temporaneo non disponibile

Ottenere la risposta ai formati di glossario supportati

Tipo di base per l'elenco restituito nell'API Ottenere formati di glossario supportati.

Risposta dei formati di glossario supportati

Tipo di base per l'elenco restituito nell'API Ottenere formati di glossario supportati.

Nome	Tipo	Descrizione
value	FileFormat []	FileFormat[] contiene i dettagli elencati.
value.contentTypes	string []	Tipi di contenuto supportati per questo formato.
value.defaultVersion	string	Versione predefinita se non è specificato nessuno
value.fileExtensions	string []	Estensione di file supportata per questo formato.
value.format	string	Nome del formato.
value.versions	string []	Versione supportata.

Risposta con errore

Nome	Tipo	Descrizione
codice	string	Enumerazioni contenenti codici di errore di alto livello. Valori possibili: • InternalServerError • InvalidArgument • InvalidRequest • RequestRateTooHigh • ResourceNotFound • Servizio Non disponibile • Non autorizzato
messaggio	string	Ottiene un messaggio di errore di alto livello.
innerError	InnerTranslationError	Nuovo formato di errore interno conforme alle linee guida dell'API dei servizi di intelligenza artificiale di Azure. Questo messaggio di errore contiene le proprietà necessarie ErrorCode, message e proprietà facoltative target, details(coppia chiave-valore), errore interno(può essere annidato).
innerError.code	string	Ottiene la stringa di errore del codice.
innerError.message	string	Ottiene un messaggio di errore di alto livello.
innerError.target	string	Ottiene l'origine dell'errore. Ad esempio, sarebbe `documents` o `document id` se il documento non fosse valido.

Esempi

Esempio di risposta riuscita

L'oggetto JSON seguente è un esempio di risposta riuscita.

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

Esempio di risposta di errore

L'oggetto JSON seguente è un esempio di risposta di errore. Lo schema per altri codici di errore è lo stesso.

Codice di stato: 500

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

Passaggi successivi

Seguire la guida introduttiva per altre informazioni sull'uso della traduzione dei documenti e della raccolta client.

Introduzione alla traduzione di documenti

Condividi tramite