Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Texttransliterations-API ordnet Ihr Quellsprachenskript oder -alphabet einem Zielsprachenskript oder -alphabet zu.
Anfrage-URL
Senden Sie eine POST Anforderung an:
https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0
SieheVirtual Network Support for Translator selected network and private endpoint configuration and support.see Virtual Network Support for Translator selected network and private endpoint configuration and support.
Anforderungsparameter
Anforderungsparameter, die an die Abfragezeichenfolge übergeben werden, sind:
| Query parameter (Abfrageparameter) | Description |
|---|---|
| API-Version |
Erforderlicher Parameter. Version der API, die vom Client angefordert wird. Der Wert muss 3.0 sein. |
| language |
Erforderlicher Parameter. Gibt die Sprache des Texts an, der von einem Skript in ein anderes konvertiert werden soll. Mögliche Sprachen werden im Bereich aufgeführt, der transliteration durch Abfragen des Diensts für die unterstützten Sprachen abgerufen wird. |
| fromScript |
Erforderlicher Parameter. Gibt das skript an, das vom Eingabetext verwendet wird. Suchen Sie nach unterstützten Sprachen mithilfe des transliteration Bereichs, um Eingabeskripts zu finden, die für die ausgewählte Sprache verfügbar sind. |
| toScript |
Erforderlicher Parameter. Gibt das Ausgabeskript an. Suchen Sie mithilfe des Bereichs transliteration, um Ausgabeskripts für die ausgewählte Kombination aus Eingabesprache und Eingabeskript zu finden. |
Anforderungsheader
| Headers | Description |
|---|---|
| Authentifizierungsheader |
Erforderlicher Anforderungsheader. Weitere Informationen finden Sie unter den verfügbaren Optionen für die Authentifizierung. |
| Inhaltstyp |
Erforderlicher Anforderungsheader. Gibt den Inhaltstyp der Nutzlast an. Mögliche Werte sind: application/json |
| Inhaltslänge |
Optional Die Länge des Anforderungstexts. |
| X-ClientTraceId |
Optional Eine vom Client generierte GUID, um die Anforderung eindeutig zu identifizieren. Sie können diesen Header weglassen, wenn Sie die Ablaufverfolgungs-ID in die Abfragezeichenfolge mithilfe eines Abfrageparameters mit dem Namen ClientTraceIdeinschließen. |
Anfragekörper
Der Textkörper der Anforderung ist ein JSON-Array. Jedes Arrayelement ist ein JSON-Objekt mit einer Zeichenfolgeneigenschaft namens Text, die die zu konvertierende Zeichenfolge darstellt.
[
{"text":"こんにちは"},
{"text":"さようなら"}
]
Es gelten die folgenden Einschränkungen:
- Das Array kann höchstens 10 Elemente aufweisen.
- Der Textwert eines Arrayelements darf 1.000 Zeichen einschließlich Leerzeichen nicht überschreiten.
- Der gesamte text, der in der Anforderung enthalten ist, darf 5.000 Zeichen einschließlich Leerzeichen nicht überschreiten.
Antworttext
Eine erfolgreiche Antwort ist ein JSON-Array mit einem Ergebnis für jedes Element im Eingabearray. Ein Ergebnisobjekt enthält die folgenden Eigenschaften:
text: Eine Zeichenfolge, die aus der Konvertierung der Eingabezeichenfolge in das Ausgabeskript resultiert.script: Eine Zeichenfolge, die das in der Ausgabe verwendete Skript angibt.
Beispiel für eine JSON-Antwort:
[
{"text":"konnnichiha","script":"Latn"},
{"text":"sayounara","script":"Latn"}
]
Antwortkopfzeilen
| Headers | Description |
|---|---|
| X-RequestId | Vom Dienst generierter Wert, um die Anforderung zu identifizieren und für Problembehandlungszwecke verwendet zu werden. |
Statuscodes für Antworten
Nachfolgend sind die möglichen HTTP-Statuscodes aufgeführt, die von einer Anforderung zurückgegeben werden.
| Statuscode | Description |
|---|---|
| 200 | Erfolg. |
| 400 | Einer der Abfrageparameter fehlt oder ist ungültig. Korrigieren Sie die Anforderungsparameter, bevor Sie den Vorgang wiederholen. |
| 401 | Die Anforderung konnte nicht authentifiziert werden. Überprüfen Sie, ob Anmeldeinformationen angegeben und gültig sind. |
| 403 | Die Anforderung ist nicht autorisiert. Überprüfen Sie die Fehlermeldung "Details". Dieser Code gibt häufig an, dass alle kostenlosen Übersetzungen, die mit einem Testabonnement bereitgestellt werden, verwendet werden. |
| 429 | Der Server hat die Anforderung abgelehnt, da der Client die Anforderungsgrenzwerte überschritten hat. |
| 500 | Ein unerwarteter Fehler ist aufgetreten. Wenn der Fehler weiterhin besteht, melden Sie ihn mit: Datum und Uhrzeit des Fehlers, Anforderungsbezeichner vom Antwortheader und Client-ID aus Anforderungsheader X-RequestIdX-ClientTraceId. |
| 503 | Der Server ist vorübergehend nicht verfügbar. Wiederholen Sie die Anforderung. Wenn der Fehler weiterhin besteht, melden Sie ihn mit: Datum und Uhrzeit des Fehlers, Anforderungsbezeichner vom Antwortheader und Client-ID aus Anforderungsheader X-RequestIdX-ClientTraceId. |
Wenn ein Fehler auftritt, gibt die Anforderung auch eine JSON-Fehlerantwort zurück. Der Fehlercode ist eine 6-stellige Zahl, die den 3-stelligen HTTP-Statuscode kombiniert, gefolgt von einer 3-stelligen Zahl, um den Fehler weiter zu kategorisieren. Allgemeine Fehlercodes finden Sie auf der v3 Translator-Referenzseite.
Examples
Das folgende Beispiel zeigt, wie zwei japanische Zeichenfolgen in romanisiertes Japanisch konvertiert werden.
Die JSON-Nutzlast für die Anforderung in diesem Beispiel:
[{"text":"こんにちは","script":"jpan"},{"text":"さようなら","script":"jpan"}]
Wenn Sie cURL in einem Befehlszeilenfenster verwenden, das Unicode-Zeichen nicht unterstützt, nehmen Sie die folgende JSON-Nutzlast, und speichern Sie sie in einer Datei mit dem Namen request.txt. Achten Sie darauf, die Datei mit UTF-8 Codierung zu speichern.
curl -X POST "https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn" -H "X-ClientTraceId: 875030C7-5380-40B8-8A03-63DACCF69C11" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d @request.txt