Es wird zwischen den zu übertragenden und den zu empfangenden Daten unterschieden.
Der Client bestimmt über HTTP-Header über die Parameter ‚content-type' und ‚accept' in welchem Format er Daten sendet und in welchem er Daten empfängt.
Wird kein oder kein bekanntes Empfangs-Format übergeben wird als Standard JSON zurückgegeben.
Gültige Formate sind:
Typ | Senden: | Empfang: | Info |
application/x-www-form-urlencoded | x | - | Daten URL-Encoded |
application/json | x | x | Daten in JSON |
application/xml | x | x | Daten in XML, erst experimentel verfügbar zum Lesen von Daten |
application/octet-stream Wird nur akzeptiert, wenn ein einziges binäres Feld gelesen, eingefügt oder aufdatiert werden soll. | x | x | Binäre Daten, in Entwicklung |
text/plain | - | x | Formatierte Felder werden als Text ausgegeben. Felder können intern in RTF oder HTM formatiert gespeichert sein. In der REST-Schnittstelle ist dies nicht immer erwünscht. Mit dieser Option werden die Daten als unformatierter Text ausgegeben. |
Die Sende- und Empfangs-Format sind frei kombinierbar, ebenso gewisse accept-Optionen untereinander.
Bsp. Ausgabe in JSON und Konvertierung formatierter Texte in reinen Text:
accept: application/json; text/plain