Translator 3.0: BreakSentence

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

Richiesta URL

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.

Parametri della richiesta

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.

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 di 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 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 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 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.

Esempi

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