Authentifizierung (AUTH)

Beschreibung

Jeder Request zum Abruf oder dem Schreiben von Daten benötigt die vorherige Authentifizierung. Der AUTH-Request gibt einen Token zurück, der für folgende Requests zur Autorisierung übergeben werden muss.

Method: GET

Request-URL: /auth

Request-Headers:

Name	Value (Beschreibung)
apikey	API-Key des Drittanbieters (string; length: 64)
apisecret	API-Secret des Drittanbieters (string; length: 64)
user-agent	App.<identifier> (Identifier: Siehe Liste unter Zusätzliche Informationen)

In der aktuellen Version nimmt die API ausschließlich HTTP/1.1 Requests an. Andere Requests werden nicht ausgeführt.

URL-Parameters:

keine

Zusätzliche Informationen

Shopsystem	Identifier
3rd-party / Integration über Drittanbieter	E5G
Azoo	AJ4
DomainFactory	X6G
ePages	FB6
Gambio	W8F
HostEurope	D8N
IONOS	PL7
JTL-Shop	T6Z
Magento	AE2
Modified	RF5
OpenCart	N7P
PlentyMarkets	K4V
Prestashop	KR2
Self-programmed	HL3
Serverspot	S3T
Shopify	GF3
Shopware	GDX
SmartStore	TV1
Strato	M3F
Telekom	B5Z
VersaCommerce	Q6T
WooCommerce	SB3
xt:Commerce	5ZK

Beispiel

GET https://api.shopvote.de/auth

Response (JSON)

{"Code":200,"Token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE1ODQ3ODQ2NDcuMzQ4Mywic2hvcGlkIjoiMTQwNCIsImp0aSI6IjY4MjdiNDY0NzYzNmUzMTI3NTMyNTU2MTNmODFkZTU0In0.Pgji_KK6XO1HVUvZR2qMCxDAwXxf0IzvM8QbsIK4UnU"}

Informationen zum JSON-Web-Token (JWT): https://jwt.io
JSON Web Token Standard (RFC7519): https://datatracker.ietf.org/doc/html/rfc7519

Payload des JSON-Web-Token

{
  "iat": 1584784647.3483,
  "shopid": "1404",
  "jti": "6827b4647636e312753255613f81de54"
}

Claim	Bedeutung
iat	Unix-Zeitstempel der Generierung des JWT (Unix-Timestamp, Microtime)
shopid	Gibt die ShopID des Shops an, für den der Request durchgeführt wurde.
jti	Unique-JWT-Identifier