RetailForce Cloud API

RetailForce Cloud API poskytuje všechny funkce Cloudového portálu. Lze jej použít k automatizaci procesů nebo k volání funkcí z externích systémů, aniž by bylo nutné se přihlašovat do portálu a provádět činnosti ručně.

Ověřování

Aby bylo možné funkce využívat, musí se systém, který je vyvolává, ověřit u Cloudového systému. Následující text popisuje ruční ověření i příklady volání řízených událostmi.

Přístup přes api.retailForce.cloud.cloud

Cloud API je k dispozici na následující adrese URL:

• https://api.retailforce.cloud/swagger/index.html

Ruční ověření

Ověření se provádí pomocí CloudApiKey a CloudApiSecret a vygenerováním Bearer Tokenu.

1. Volání koncového bodu

1. Klikněte na koncový bod POST /api/v1.0/authenticate/logon, aby se sekce rozbalila.
2. Do příslušných polí zadejte svůj apiKey a apiKeySecret.
3. Proveďte požadavek a získejte token Bearer.

2. Použití tokenu Bearer

1. Zkopírujte token Bearer z ResponseBody.
2. Klikněte na tlačítko „Authorize“ v pravém horním rohu rozhraní Swagger UI.
3. Zadejte token Bearer do dialogového okna. Formát: Bearer <token> (za „Bearer“ vložte mezeru).
4. Klikněte na „Autorizovat“

Automatické ověření

Automatické ověření umožňuje systémům bezpečný přístup k rozhraní RetailForce Cloud API bez zásahu uživatele, což je ideální pro služby běžící na pozadí, automatizované pracovní postupy nebo pravidelné dotazy na data.

1. Ověření a získání tokenu Bearer:

Odešlete požadavek POST s vašimi přihlašovacími údaji API na autentizační koncový bod.

curl -X POST "https://api.retailforce.cloud/api/v1.0/authenticate/logon" \
-H "Content-Type: multipart/form-data" \
-F "key=cloudApiKey" \
-F "secret=cloudApiSecret"

Po úspěšném ověření obdržíte v ResponseBody token Bearer, který je nezbytný pro autorizaci dalších požadavků na API.

2. Přístup k koncovým bodům:

K přístupu ke koncovým bodům použijte obdržený token Bearer.

Příklad:

curl -X 'GET' \
'https://api.retailforce.cloud/api/v1.0/someEndpoint' \
-H 'accept: text/plain' \
-H 'Authorization: Bearer {yourBearerToken}'

Důležité: Uchovávejte své přihlašovací údaje k API a tokeny v bezpečí, abyste zabránili neoprávněnému přístupu.

Cloudová fiskalizace

„Cloudová fiskalizace“ označuje poskytování fiskalizačního middlewaru RetailForce jako hostovanou cloudovou službu. Službu provozuje společnost RetailForce v cloudovém prostředí.

Přístup přes fiscalisation.retailforce.cloud Cloud

K službě se dostanete přes následující odkaz:

• https://fiscalisation.retailforce.cloud/swagger/index.html

Ruční ověření

Pro ověření v rámci služby RetailForce Cloud Fiscalization prostřednictvím rozhraní Swagger UI existují dvě možnosti:

1. Otevřete Swagger UI a klikněte na „Authorize“.
2. Metody ověření
   1. Přihlašovací údaje do portálu (e-mail a heslo):
      • Umožňují přístup k více organizacím.
   2. API klíč a tajný klíč:
      • Obvykle jsou spojeny s konkrétním distributorem nebo organizací.
3. Klikněte na „Autorizovat“

Nyní máte oprávnění k testování a zahájení používání cloudové fiskalizace.

Tento článek byl přeložen automaticky.