Traduttore 3.0: Rilevare

Articolo
09/01/2024

Identifica la lingua di una parte del testo.

Richiesta URL

Inviare una richiesta POST a:

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

Vedere Rete virtuale Supporto per il servizio Translator selezionato per la configurazione e il supporto di endpoint privati e di rete.

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	Facoltativo. 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. L'autodetection della lingua funziona meglio con 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, score, isTranslationSupportede isTransliterationSupported.

Una risposta JSON di esempio è:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

Intestazioni della risposta

Intestazioni	Descrizione
X-RequestId	Valore generato dal servizio per identificare la richiesta e usata 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	Esito positivo.
400	Uno dei parametri di query manca o non è valido. Prima di riprovare, correggere i parametri della richiesta.
401	Impossibile 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 vengono usate tutte le traduzioni gratuite fornite con una sottoscrizione di valutazione.
429	Il server ha rifiutato la richiesta perché il client ha superato i limiti delle richieste.
500	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.

Esempi

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?'}]"

Condividi tramite