Translator 3.0: BreakSentence
Identifica il posizionamento dei delimitatori di frase in una porzione di testo.
Inviare una richiesta POST
a:
https://api.cognitive.microsofttranslator.com/breaksentence?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.
I parametri della richiesta inviati a una stringa di query sono:
Parametro query | Descrizione |
---|---|
api-version | Parametro di query obbligatorio. Versione dell'API richiesta dal client. Il valore deve essere 3.0 . |
lingua | Parametro di query facoltativo. Tag di lingua che identifica la lingua del testo di input. Se non viene specificato un codice, viene applicato il rilevamento automatico della lingua. |
script | Parametro di query facoltativo. Tag dell'alfabeto che identifica i caratteri usati dal testo di input. Se non viene specificato uno script, si presuppone lo script predefinito del linguaggio. |
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 . |
Il corpo della richiesta è una matrice JSON. Ogni elemento della matrice è un oggetto JSON con una proprietà stringa denominata Text
. I delimitatori di frase vengono calcolati per il valore della proprietà Text
. Di seguito è riportato un esempio di corpo della richiesta con una porzione di testo:
[
{ "Text": "How are you? I am fine. What did you do today?" }
]
Si applicano le limitazioni seguenti:
- La matrice deve essere composta al massimo da 100 elementi.
- Il valore di testo di un elemento di matrice non può superare i 50.000 caratteri, inclusi gli spazi.
- L'intero testo incluso nella richiesta non può superare i 50.000 caratteri, inclusi gli spazi.
- Se viene specificato il parametro di query
language
, tutti gli elementi di matrice devono essere nella stessa lingua. In caso contrario, la funzione automatica del linguaggio viene applicata a ogni elemento di matrice in modo indipendente.
Una risposta corretta è una matrice JSON con un risultato per ogni stringa nella matrice di input. Un oggetto risultato include le proprietà seguenti:
sentLen
: matrice di interi che rappresenta le lunghezze delle frasi nell'elemento di testo. La lunghezza della matrice è il numero di frasi e i valori sono la lunghezza di ogni frase.detectedLanguage
: oggetto che descrive la lingua rilevata tramite le proprietà seguenti:language
: codice della lingua rilevata.score
: valore float che indica il livello di attendibilità del risultato. Il punteggio è compreso tra zero (0) e uno (1,0). Un punteggio basso (<= 0,4) indica una bassa confidenza.
La detectedLanguage
proprietà è presente nell'oggetto risultato solo quando viene richiesta la funzionalità automatica della lingua.
Una risposta JSON di esempio è:
[
{
"detectedLanguage": {
"language": "en",
"score": 1.0
},
"sentLen": [
13,
11,
22
]
}
]
Intestazioni | Descrizione |
---|---|
X-RequestId | Valore generato dal servizio per identificare la richiesta e usata per la risoluzione dei problemi. |
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 di risposta 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.
L'esempio seguente mostra come ottenere i delimitatori di frase per una singola frase. Il servizio rileva automaticamente la lingua delle frasi.
curl -X POST "https://api.cognitive.microsofttranslator.com/breaksentence?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'How are you? I am fine. What did you do today?'}]"