RetailForce Cloud API

RetailForce Cloud API poskytuje všetky funkcie RetailForce Cloud Portal. Môže sa použiť na automatizáciu procesov alebo na volanie funkcií z externých systémov bez nutnosti prihlásenia sa do portálu a manuálneho vykonávania činností.

Overovanie

Na používanie týchto funkcií sa systém, ktorý odosiela požiadavku, musí autentizovať voči cloudovému systému. Nižšie je popísaná manuálna autentizácia, ako aj príklady volaní riadených udalosťami.

Prístup cez api.RetailForce.cloud

Cloud API je k dispozícii na nasledujúcej adrese URL:

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

Ručné overenie

Overenie sa vykonáva prostredníctvom cloudApiKey a cloudApiSecret a vygenerovaním Bearer Tokenu.

1. Koncový bod volania

1. Kliknutím na koncový bod POST /api/v1.0/authenticate/logon rozbalíte túto sekciu.
2. Do príslušných polí zadajte svoje apiKey a apiKeySecret.
3. Vykonajte požiadavku, aby ste získali token Bearer.

2. Použitie Bearer Tokenu

1. Skopírujte token Bearer z ResponseBody.
2. Kliknite na tlačidlo „Authorize“ v pravom hornom rohu rozhrania Swagger UI.
3. Zadajte token Bearer do dialógového okna. Formát: Bearer <token> (za „Bearer“ vložte medzera).
4. Kliknite na „Autorizovať“

Automatické overenie

Automatické overenie umožňuje systémom bezpečný prístup k RetailForce Cloud API bez interakcie používateľa, čo je ideálne pre služby bežiace na pozadí, automatizované pracovné postupy alebo pravidelné dotazy na údaje.

1. Overenie a získanie tokenu Bearer:

Odošlite požiadavku POST s vašimi prihlasovacími údajmi api na autentifikač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 úspešnom overení identite dostanete v ResponseBody token Bearer, ktorý je potrebný na autorizáciu ďalších požiadaviek na api.

2. Prístup k koncovým bodom:

Použite prijatý token Bearer na prístup k koncovým bodom.

Príklad:

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

Dôležité: Svoje prihlasovacie údaje a tokeny api uchovávajte v bezpečí, aby ste zabránili neoprávnenému prístupu.

Cloudová fiskalizácia

„Cloudová fiskalizácia“ označuje poskytovanie fiskalizačného middlewaru RetailForce ako hostovanej cloudovej služby. Túto službu prevádzkuje spoločnosť RetailForce v cloudovom prostredí.

Prístup cez fiscalisation.RetailForce Cloud

K službe sa dostanete cez nasledujúci odkaz:

• https://fiscalisation.RetailForce.Cloud/swagger/index.html

Ručné overenie

Existujú dve možnosti overenia v službe RetailForce Cloud Fiscalization prostredníctvom rozhrania Swagger UI:

1. Otvorte rozhranie Swagger UI a kliknite na „Autorizovať“.
2. Metódy overovania
   1. Prihlasovacie údaje do portálu (e-mail a heslo):
      • Umožňujú prístup k viacerým organizáciám.
   2. Kľúč API a tajný kľúč:
      • Zvyčajne sú spojené s konkrétnym distributorom alebo organizáciou.
3. Kliknite na „Autorizovať“

Teraz máte oprávnenie na testovanie a začatie používania cloudovej fiskalizácie.

Tento článok bol preložený automaticky.