Der API Aufruf command der Webkasse POS API wird mit der Version 2 mit einer Komprimierung der Antwort der Kasse erweitert. Die bisherigen response Antworten der Version 1 entfallen, Fehler und ratelimit werden ausgegeben. Alle Antworten der Kasse werden in ein neues Objekt "posResponse" geschrieben . Das Objekt posResponse kann zusätzlich komprimiert werden.
ASQL-Befehl senden (command v2)
Mögliche ASQL Befehle: ASQL Programmierung: Übersicht.
Aufruf command:
POST ... /extern/webcashregister/command
POST-Parameter ASQL:
zwei zusätzliche Parameter stellen auf die Version 2 und die Komprimierung um. Auf diese Weise ist v2 abwärtskompatibel.
Die Komprimierung erfolgt mit base64 Encode.
parameter | typ | Beschreibung |
---|---|---|
version | <int> [1,2] | wenn nicht übergeben, wird v1=1 gesetzt |
compress | <int> [0,1] | wenn nicht übergeben, wird 0 gesetzt |
In der Antwort wird nun zusätzlich immer auch das aktuelle ratelimit mit ausgegeben.
Antwort-Beispiel command v2, Kompression aus (Fehler: Kasse nicht online):
{ "requestStatus": "success", "errorMessage": "", "errorNUmber": 0, "currentRateLimit": 4, "posResponse": "{\"status\":\"error\",\"message\":\"pos not online \"}\n" }
Antwort-Beispiel command v2, Kompression base64 Encode an (Fehler: Kasse nicht online):
{ "requestStatus": "success", "errorMessage": "", "errorNUmber": 0, "currentRateLimit": 5, "posResponse": "eJyrViouSSwpLVayUkotKsovUtJRyk0tLk5MTwWKFOQXK+Tllyjk5+Vk5qUqKNVyAQCIeg/u" }