RetailForce Cloud API

RetailForce Cloud API pruža sve funkcije Cloud portala. Može se koristiti za automatizaciju procesa ili za pozivanje funkcija iz vanjskih sistema bez prijave na portal i ručnog obavljanja aktivnosti.

Autentifikacija

Da bi se koristile funkcije, sistem koji upućuje zahtjev mora se autentificirati sa cloud sistemom. U nastavku je opisana ručna autentifikacija, kao i primjeri poziva zasnovanih na događajima.

Pristup putem api.retailForce.cloud

Cloud API je dostupan na sljedećoj URL adresi:

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

Ručna autentifikacija

Autentifikacija se vrši putem CloudApiKey i CloudApiSecret te generisanja Bearer tokena.

1. Pozovite krajnju tačku

1. Kliknite na krajnju tačku POST /api/v1.0/authenticate/logon da proširite odjeljak.
2. Unesite svoj apiKey i apiKeySecret u odgovarajuća polja.
3. Pokrenite zahtjev da biste dobili Bearer Token.

2. Koristite Bearer token

1. Kopirajte Bearer Token iz ResponseBody.
2. Kliknite na dugme "Authorize" u gornjem desnom uglu Swagger korisničkog interfejsa.
3. Unesite Bearer token u dijaloški okvir. Format: Bearer <token> (ubacite razmak nakon "Bearer").
4. Kliknite na "Authorize"

Automatska autentifikacija

Automatska autentifikacija omogućava sistemima siguran pristup RetailForce Cloud API-ju bez interakcije korisnika, idealno za pozadinske usluge, automatizirane radne procese ili redovne upite podataka.

1. Autentifikacija i primanje Bearer tokena:

Pošaljite POST zahtjev sa svojim API vjerodajnicama na krajnju tačku za autentifikaciju.

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

Nakon uspješne autentifikacije, primit ćete Bearer token u ResponseBody, što je potrebno za autorizaciju daljnjih API zahtjeva.

2. Pristup krajnjim tačkama:

Koristite primljeni Bearer Token za pristup endpointima.

Primjer:

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

Važno: Čuvajte svoje API kredencijale i tokene na sigurnom kako biste spriječili neovlašteni pristup.

Oblačna fiskalizacija

"Cloud Fiscalization" se odnosi na pružanje RetailForce middlewarea za fiskalizaciju kao hostovane usluge u oblaku. Uslugu upravlja RetailForce u oblačnom okruženju.

Pristup putem fiscalisation.retailforce.cloud

Pristupite usluzi putem sljedećeg linka:

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

Ručna autentifikacija

Postoje dvije opcije za autentifikaciju na RetailForce Cloud Fiscalization putem Swagger UI-ja:

1. Otvorite Swagger UI i kliknite na "Authorize".
2. Metode autentifikacije
   1. Portalne vjerodajnice (e-mail i lozinka):
      • Omogućava pristup više organizacija.
   2. API ključ i tajna:
      • Obično povezan s određenim distributerom ili organizacijom.
3. Kliknite "Autoriziraj"

Sada ste ovlašteni da testirate i počnete koristiti oblačnu fiskalizaciju.

Ovaj članak je automatski preveden.