Das Modul LINA Voucher für Online Gutscheine hat eine eigene API Schnittstelle, mit der andere Kassensysteme oder Drittanbieter Gutscheine vonLINA verkaufen, prüfen oder einlösen können.
LINA Data API geändert (alte URL amadeus360 noch erreichbar) LINA Data URL changed to https://api.lina.de/ ...
Sicherheit
Aus Sicherheitsgründen müssen alle Aufrufe SSL-verschlüsselt sein, daher nutzen Sie bitte HTTPS Verbindungen
Alle Aufrufe sind HTTP(s), daher müssen POST-Parameter mit POST zum Server gesandt werden. Antworten sind immer JSON Pakete, zusätzliche Informationen finden Sie auf http://www.json.org/ .
Ebenfalls aus Sicherheitsgründen gibt es eine Höchstzahl fehlgeschlagener Aufrufe pro Zeit. Bekommen Sie eine Antwort "DENIED", warten Sie bitte mit weiteren Aufrufen und prüfen den Code auf Fehler.
Verbindungstest /IP-Adresse
Die erste Verbindung zur API 'Online-Gutscheine' braucht wegen der Autorisierung mit Nutzername /Passwort im angesprochenen LINA-Laden einige Zeit.. Zusätzlich wird jede Verbindung mit einem pre-shared-key und der aktuellen IP-Adresse des anfragenden Clients (ihr PC/Server) verschlüsselt. Bei Clients mit dynamisch wechselnden IP-Adressen nutzen sie die API selbst, um die IP ihres Clients abzufragen. So prüfen Sie gleichzeitig die Verfügbarkeit des LINA Service für die Online-Gutscheine.
Function „ping“
URL .../extern/tokenapi/ping
Response „ping“ Fields status "OK" Server is online "Maintenance" We are undergoing maintenance, please see our status page
myip xxx.xxx.xxx.xxx Your current IPv4 address
Authentifizierung / Generierung Hash
Jeder Funktionsaufruf außer "ping" und "login" verlangt einen Hash. Zur Generierung dieses Hash müssen sie einen login ausführen, der wiederum den login-Namen und einen verschlüsselten Hash verlangt. Dieser besteht aus dem MD5 des API-Passwortes, der aktuellen IPv4 Adresse des Clients und den pre-shared-key, den sie bekommen haben, als sie den API-key für die API "Online-Gutscheine" erstellt haben.
Function „login“ [POST]
URL .../extern/tokenapi/login
Parameters
username [String] Username for the API user
password [String] md5 ( md5 (Password) + IP-Address + Pre-Shared Key )
Resonse „login“
Codes 200 Request successful 400 Error during request Fields
status "OK" Request successful
"error" Requested failed, see "response" for reason
response Upon error, the textual error message
hash Upon success, the generated hash (40 chars)
laden The name of the store you logged into
ladenid Internal ID for the store you logged into
Nach dem erfolgreichen login benötigen sie nur noch den neu erhaltenen hash, solange sich ihre IP-Adresse nicht ändert. In allen anderen Fällen, müssen sie sich neu anmelden und einen hash generieren. Dieser ist für 2 Stunden gültig.