Traduzione 3.0: BreakSentence

  • Articolo

Identifica il posizionamento dei delimitatori di frase in una porzione di testo.

URL richiesta

Inviare una richiesta POST a:

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

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

Parametri della richiesta

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

Parametro della query Descrizione
api-version Parametro di query obbligatorio.
Versione dell'API richiesta dal client. Il valore deve essere 3.0.
Linguaggio Parametro di query facoltativo.
Tag di lingua che identifica la lingua del testo di input. Se non è specificato un codice, viene applicato il rilevamento automatico del linguaggio.
script Parametro di query facoltativo.
Tag dell'alfabeto che identifica i caratteri usati dal testo di input. Se non viene specificato uno script, viene assunto 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 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. 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 della matrice in modo indipendente.

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:

  • 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 attendibilità.

La detectedLanguage proprietà è presente solo nell'oggetto risultato quando viene richiesta l'opzione automatica della lingua.

Una risposta JSON di esempio è:

[
    {
        "detectedLanguage": {
            "language": "en",
            "score": 1.0
        },
        "sentLen": [
            13,
            11,
            22
        ]
    }
]

Intestazioni di risposta

Intestazioni Descrizione
X-RequestId Valore generato dal servizio per identificare la richiesta. Viene usato a scopo di 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 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 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 ottenere i delimitatori di frase per una singola frase. Il servizio rileva automaticamente la lingua della frase.

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