Authentification

L'accès à l'API nécessite de fournir votre APIKEY et SHOPID.

1) Obtenir un auth token

Différentes méthodes :

1. Depuis l’interface : Configuration → Webservices (le token de votre compte y est affiché).
2. Via OTP : https://kash.click/workers/getOTPForAccount.php
3. Par requête POST : https://kash.click/workers/getAuthTokenWithPassword.php

1.1.1 POST /workers/getOTPForAccount.php

Ce endpoint vous permet d'obtenir par email le mot de passe à usage unique (OTP), que vous pouvez utiliser afin d'obtenir la clé API de votre compte

{ "success": true, "result": "Email with OTP has been sent", "consumeOTPlink": "[the link to use in order to consume the OTP]"}

{ "success": false, "result": "Error sending email"}

const email = "mon.email@example.com";fetch("https://kash.click/workers/getOTPForAccount.php", { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded" }, body: new URLSearchParams({ email })}) .then(r => r.json()) .then(data => {  if (data.success) {   console.log("Now provide OTP using :", data.consumeOTPlink);  } else {   console.error("Auth error", data);  } });

1.1.2 POST /workers/getAuthTokenWithOTP.php

Ce endpoint vous permet d'obtenir la clé API de votre compte grace au mot de passe à usage unique (OTP) que vous avez reçu par email suite à l'appel de getOTPForAccount.php

{ "success": true, "result": "Here are your credentials", "APIKEY": "[votre Token]", "SHOPID": "[identifiant de compte boutique]"}

{ "success": false, "result": "OTP not found"}

const email = "mon.email@example.com";fetch("https://kash.click/workers/getAuthTokenWithOTP.php", { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded" }, body: new URLSearchParams({ email })}) .then(r => r.json()) .then(data => {  if (data.success) {   console.log("Token:", data.APIKEY);   console.log("Shop:", data.SHOPID);  } else {   console.error("Auth error", data);  } });

1.2 POST /workers/getAuthTokenWithPassword.php

Ce endpoint vous permet d'obtenir la clé API de votre compte grace à votre mot de passe et identifiant.

{ "success": true, "result":"Here are your credentials", "APIKEY": "[votre Token]", "SHOPID": "[identifiant de compte boutique]"}

{ "success": false, "result": "Authentication error"}

const login = "mon.email@example.com";const password = "myPassword";fetch("https://kash.click/workers/getAuthTokenWithPassword.php", { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded" }, body: new URLSearchParams({ login, password })}) .then(r => r.json()) .then(data => {  if (data.success) {   console.log("Token:", data.APIKEY);   console.log("Shop:", data.SHOPID);  } else {   console.error("Auth error", data);  } });

2) Avec la clé API, vous pouvez…

• Télécharger vos données de ventes
• Télécharger articles, clients, rayons, etc.
• Enregistrer des ventes