Translator 3.0: Rilevamento

Articolo
09/22/2023

Identifica la lingua di una parte del testo.

URL richiesta

Inviare una richiesta POST a:

https://api.cognitive.microsofttranslator.com/detect?api-version=3.0

VedereRete virtuale Supporto per il servizio Translator selezionato per la configurazione e la configurazione e il supporto dell'endpoint privato.

Parametri della richiesta

I parametri della richiesta inviati a una stringa di query sono:

Query parameter (Parametro di query)	Descrizione
api-version	Parametro obbligatorio. Versione dell'API richiesta dal client. Il valore deve essere `3.0`.

Le intestazioni della richiesta includono:

Intestazioni	Descrizione
Intestazioni di autenticazione	Intestazione della richiesta obbligatoria. Vedere le opzioni disponibili per l'autenticazione.
Content-Type	Intestazione della richiesta obbligatoria. Specifica il tipo di contenuto del payload. I valori possibili sono:`application/json`.
Content-Length	Intestazione della richiesta obbligatoria. Lunghezza del corpo della richiesta.
X-ClientTraceId	Facoltativo. GUID generato dal client che identifica in modo univoco la richiesta. È possibile omettere questa intestazione se nella stringa della query si include l'ID traccia usando un parametro di query denominato `ClientTraceId`.

Testo della richiesta

Il corpo della richiesta è una matrice JSON. Ogni elemento della matrice è un oggetto JSON con una proprietà stringa denominata Text. Il rilevamento della lingua viene applicato al valore della proprietà Text. La funzione di correzione automatica della lingua funziona meglio con un testo di input più lungo. Un esempio di corpo della richiesta ha un aspetto simile al seguente:

[
    { "Text": "Ich würde wirklich gerne Ihr Auto ein paar Mal um den Block fahren." }
]

Si applicano le limitazioni seguenti:

La matrice deve essere composta al massimo da 100 elementi.
L'intero testo incluso nella richiesta non può superare i 50.000 caratteri, inclusi gli spazi.

Corpo della risposta

Una risposta corretta è una matrice JSON con un risultato per ogni stringa nella matrice di input. Un oggetto risultato include le proprietà seguenti:

language: codice della lingua rilevata.
score: valore float che indica il livello di attendibilità del risultato. Il punteggio è compreso tra zero e uno e un punteggio basso indica un'attendibilità bassa.
isTranslationSupported: valore booleano true se la lingua rilevata è una delle lingue supportate per la traduzione testuale.
isTransliterationSupported: valore booleano true se la lingua rilevata è una delle lingue supportate per la traslitterazione.
alternatives: una matrice di altre lingue possibili. Ogni elemento della matrice è un altro oggetto le proprietà seguenti: language, scoreisTranslationSupported e isTransliterationSupported.

Una risposta JSON di esempio è:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

Intestazioni di risposta

Intestazioni	Descrizione
X-RequestId	Valore generato dal servizio per identificare la richiesta. Viene usato per la risoluzione dei problemi.

Codici di stato della risposta

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

Codice di stato	Descrizione
200	Operazione completata.
400	Uno dei parametri di query non è presente o non è valido. Prima di riprovare, correggere i parametri della richiesta.
401	Non è stato possibile autenticare la richiesta. Verificare che le credenziali siano state specificate e che siano valide.
403	La richiesta non è autorizzata. Controllare il messaggio di errore per i dettagli. Questo codice indica spesso che tutte le traduzioni gratuite fornite con una sottoscrizione di valutazione sono state usate.
429	Il server ha rifiutato la richiesta perché il client ha superato i limiti delle richieste.
500	Si è verificato un errore imprevisto. Se l'errore persiste, segnalarlo specificando data e ora dell'errore, identificatore della richiesta dall'intestazione della riposta `X-RequestId` e identificatore del client dall'intestazione della richiesta `X-ClientTraceId`.
503	Il server è temporaneamente non disponibile. ripetere la richiesta. Se l'errore persiste, segnalarlo specificando data e ora dell'errore, identificatore della richiesta dall'intestazione della riposta `X-RequestId` e identificatore del client dall'intestazione della richiesta `X-ClientTraceId`.

Se si verifica un errore, la richiesta restituisce una risposta di errore JSON. Il codice errore è un numero a 6 cifre che combina il codice di stato HTTP a 3 cifre seguito da un numero a 3 cifre per classificare ulteriormente l'errore. I codici di errore più comuni sono reperibili nella pagina di riferimento Traduttore v3.

Esempio

L'esempio seguente mostra come recuperare le lingue supportate per la traduzione del testo.

curl -X POST "https://api.cognitive.microsofttranslator.com/detect?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'What language is this text written in?'}]"

Share via