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 sustava bez prijave na portal i ručnog obavljanja aktivnosti.

Autentifikacija

Za korištenje funkcija, sustav koji upućuje zahtjev mora se autentificirati u oblak sustav. U nastavku je opisana ručna autentifikacija, kao i primjeri poziva vođenih događajima.

Pristup putem api.retailForce.cloud

Cloud API dostupan je na sljedećoj URL adresi:

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

Ručna autentifikacija

Autentifikacija se provodi putem CloudApiKey i CloudApiSecret te generiranja Bearer tokena.

1. Pozovite krajnju točku

1. Kliknite na krajnju točku POST /api/v1.0/authenticate/logon kako biste proširili odjeljak.
2. Unesite svoj apiKey i apiKeySecret u odgovarajuća polja.
3. Pokrenite zahtjev kako biste primili Bearer token.

2. Korištenje Bearer tokena

1. Kopirajte Bearer token iz ResponseBody.
2. Kliknite gumb "Authorize" u gornjem desnom kutu Swagger korisničkog sučelja.
3. Unesite Bearer token u dijaloški okvir. Format: Bearer <token> (ubacite razmak nakon "Bearer").
4. Kliknite "Authorize"

Automatska autentifikacija

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

1. Autentifikacija i primanje Bearer tokena:

Pošaljite POST zahtjev sa svojim API vjerodajnicama na krajnju toč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 toč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 vjerodajnice i tokene na sigurnom kako biste spriječili neovlašteni pristup.

Oblačna fiskalizacija

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

Pristup putem fiscalisation.retailforce.cloud

Pristupite usluzi putem sljedeće poveznice:

• 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. Korisničke vjerodajnice portala (e-pošta i lozinka):
      • Omogućuje pristup više organizacija.
   2. API ključ i tajna:
      • Obično povezano s određenim distributerom ili organizacijom.
3. Kliknite "Oautoriziraj"

Sada ste ovlašteni za testiranje i početak korištenja oblačne fiskalizacije.

Ovaj je članak automatski preveden.