HTTP-Header

Dieser Abschnitt beschreibt die HTTP-Header, die die API von jeder Anfrage akzeptiert.

Content-Type

Alle Anfragen müssen einen HTTP-Header vom Typ Content-Type enthalten.

Akzeptierte Content-Types

Basisformat	Content-Types	Content-Types
JSON	application/json	text/json ist derzeit kein akzeptierter Content-Type
Formulardaten	multipart/form-data	Nur beim Hochladen von Varianten verwendet

Content-Type-Fehler

Antwortcode	Hinweise
400	Der Content-Type wurde verstanden, konnte aber nicht decodiert werden. Weitere Informationen erscheinen im Antworttext
415	Der Content-Type fehlt oder wird nicht unterstützt

Hinweis: In Fällen, in denen der Content-Type-Header ein Problem hat, ist der Antwort-Content-Type das Standardformat für die API, derzeit application/json

Hinweis: Die API hält sich derzeit nicht an den Accept-Type HTTP-Header; alle Antworten werden im selben Content-Type gesendet wie die empfangene Anfrage, vorausgesetzt, der Content-Type der Anfrage war gültig

Autorisierung

Dieser Header ist optional und wird verwendet, um der API Authentifizierungsdetails für den aktuellen Benutzer bereitzustellen, wodurch der aktuelle Benutzer auf eingeschränkte API-Ressourcen zugreifen kann. Tokens können über die Login-API bezogen werden. Ein Beispiel-Header ist:

Authorization: Bearer 45267dbe480c8c7d799c62ccad92cb44f67ab086

Der Authorization-Header akzeptiert einen String, der aus zwei durch ein einzelnes Leerzeichen getrennten Teilen besteht. Der erste Teil ist der Token-Typ, der zweite der Access-Token selbst.

Autorisierungsfehler

Antwortcode	Hinweise
400	Ein fehlerhaft formatierter Authorization-Header wurde bereitgestellt
401	Der Authorization-Header fehlt oder das Token war ungültig oder abgelaufen

Auswahl eines Authorization-Token-Typs

Bei jedem Fehler enthalten die Antwort-Header einen WWW-Authenticate-Header, der den für den Zugriff erforderlichen Token-Typ angibt.