REST API Unterstützung landessprachlicher Versionen

Die REST API unterstützt mit gewissen Einschränkungen die Möglichkeit, Landessprachen als Teil HTTP anzugeben.

Hintergrund

HTTP ermöglichen es, bei Anfragen ein bestimmtes Verhalten festzulegen und in Antworten zusätzliche Informationen bereitzustellen.

In den HTTP-Headern ist die Möglichkeit enthalten, dass Informationen in einer Landessprache zurückgegeben werden. REST API berücksichtigt diesen Header nach Möglichkeit.

Eine Landessprache angeben

Im HTTP-Header ACCEPT-LANGUAGE können ein oder mehrere Sprachentags angegeben werden. Optional können Sie einen Rang mit den Tags verknüpfen, sodass die Spezifikation einer Liste nach Vorgabe sortiert werden kann. Auf dieser Seite finden Sie eine hilfreiche Erläuterung dieses Grundsatzes.

Der REST API berücksichtigt diesen Header, wählt eine Sprache aus dem Header ACCEPT-LANGUAGE aus und gibt Nachrichten in dieser Sprache zurück. Wenn der Header ACCEPT-LANGUAGE keine Sprache enthält, die REST API unterstützen kann, werden Nachrichten in einer Standardsprache zurückgegeben. Diese Standardsprache entspricht der Standardländereinstellung des REST API -Web-Servers.

Welche Daten werden übersetzt? Im Abschnitt wird erläutert, welche Daten übersetzt werden.

Angeben der anwendbaren Sprache in den Antworten

HTTP "CONTENT-LANGUAGE" in den Antworten von REST API gibt die Sprache an, in der die Nachrichten zurückgesendet werden.

Welche Daten werden übersetzt?

Fehler-und Informationsnachrichten werden übersetzt, andere Texte nicht.
  • Daten, die von einem Warteschlangenmanager zurückgegeben werden, werden nicht übersetzt. Wenn beispielsweise ein MQSC-Befehl über REST APIausgeführt wird, entsprechen die Antworten des Warteschlangenmanagers der Ländereinstellung des Warteschlangenmanagers.
  • Die generierte (Swagger-) Dokumentation für REST API, die über das Feature apiDiscovery zugänglich gemacht wird, ist in Englisch.

Welche Sprachen werden unterstützt?

Neben Englisch werden REST API -Fehlernachrichten und -Informationsnachrichten in die folgenden Sprachen übersetzt.
Chinesisch (Vereinfacht)
Durch den Sprachentag zh_CN verweigert
Chinesisch (traditionell)
Durch den Sprachentag zh_TW verweigert
Tschechisch
Durch den Sprachentag cs verweigert
Französisch
Durch den Sprachentag fr verweigert
Ungarisch
Durch den Sprachentag hu verweigert
Italienisch
Durch den Sprachentag it verweigert
Japanisch
Durch den Sprachentag ja verweigert
Koreanisch
Durch den Sprachentag ko verweigert
Polnisch
Durch den Sprachentag pl verweigert
Portugiesisch (Brasilien)
Durch den Sprachentag pt_BR verweigert
Spanisch
Durch den Sprachentag es verweigert

Beispiele

In den Beispielen weist der Web-Server eine englische Standardländereinstellung auf.

Eine einzelne unterstützte Sprache angeben
In den Anforderungsheadern ist ACCEPT-LANGUAGE auf fr gesetzt. Diese Einstellung gibt an, dass Französisch die bevorzugte Sprache für übersetzbaren Text ist.
In den Antwortheadern wird CONTENT-LANGUAGE auf fr gesetzt. Diese Einstellung gibt an, dass in der Antwort Fehler-und Informationsnachrichten in Französisch angezeigt werden.
Angeben einer Liste von Sprachen
In den Anforderungsheadern ist ACCEPT-LANGUAGE auf am, fr gesetzt. Diese Einstellung gibt an, dass Amharic und Französisch akzeptable Sprachen für übersetzbaren Text sind und dass Amharic die bevorzugte Sprache für den übersetzbaren Text ist.
In den Antwortheadern wird CONTENT-LANGUAGE auf fr gesetzt. Diese Einstellung gibt an, dass Fehler-und Informationsnachrichten in der Antwort in Französisch angezeigt werden, da REST API Amharic nicht unterstützt.
Eine einzelne nicht unterstützte Sprache angeben
In den Anforderungsheadern ist ACCEPT-LANGUAGE auf am gesetzt. Diese Einstellung gibt an, dass Amharic die bevorzugte Sprache für übersetzbaren Text ist.
In den Antwortheadern wird CONTENT-LANGUAGE auf en gesetzt. Diese Einstellung gibt an, dass Fehler-und Informationsnachrichten in der Antwort in Englisch angezeigt werden, weil REST API Amharic nicht unterstützt.