RetailForce Cloud API

RetailForce Cloud API oferă toate funcțiile RetailForce Cloud Portal. Acesta poate fi utilizat pentru automatizarea proceselor sau pentru apelarea funcțiilor din sisteme externe fără a fi necesară autentificarea în portal și efectuarea manuală a activităților.

Autentificare

Pentru a utiliza funcțiile, sistemul solicitant trebuie să se autentifice în sistemul Cloud. În continuare este descrisă autentificarea manuală, precum și exemple de apeluri declanșate de evenimente.

Acces prin api.retailForce.cloud

Cloud API este disponibil la următoarea adresă URL:

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

Autentificare manuală

Autentificarea se realizează prin intermediul cloudApiKey și cloudApiSecret și prin generarea unui Bearer Token.

1. Punct de acces

1. Faceți clic pe punctul de acces POST /api/v1.0/authenticate/logon pentru a extinde secțiunea.
2. Introduceți apiKey și apiKeySecret în câmpurile corespunzătoare.
3. Executați solicitarea pentru a primi un Bearer Token.

2. Utilizarea tokenului Bearer

1. Copiați tokenul Bearer din ResponseBody.
2. Faceți clic pe butonul „Autorizare” din colțul din dreapta sus al interfeței Swagger UI.
3. Introduceți Bearer Token în caseta de dialog. Format: Bearer <token> (introduceți un spațiu după „Bearer”).
4. Faceți clic pe „Autorizare”

Autentificare automată

Autentificarea automată permite sistemelor să acceseze în siguranță RetailForce Cloud API fără interacțiunea utilizatorului, fiind ideală pentru servicii care rulează în fundal, fluxuri de lucru automatizate sau interogări regulate de date.

1. Autentificare și primirea tokenului Bearer:

Trimiteți o cerere POST cu datele dvs. de autentificare api către punctul final de autentificare.

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

După autentificarea cu succes, veți primi un token Bearer în ResponseBody, care este necesar pentru autorizarea cererilor api ulterioare.

2. Accesarea punctelor finale:

Utilizați tokenul „Bearer” primit pentru a accesa punctele finale.

Exemplu:

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

Important: Păstrați în siguranță datele de autentificare și token-urile api pentru a preveni accesul neautorizat.

Fiscalizarea în cloud

„Fiscalizarea în cloud” se referă la furnizarea middleware-ului de fiscalizare RetailForce ca serviciu găzduit în cloud. Serviciul este operat de RetailForce în mediul cloud.

Acces prin fiscalisation.RetailForce Cloud

Accesați serviciul prin intermediul următorului link:

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

Autentificare manuală

Există două opțiuni de autentificare la RetailForce Cloud Fiscalization prin intermediul interfeței Swagger UI:

1. Deschideți Swagger UI și faceți clic pe „Autorizare”.
2. Metode de autentificare
   1. Datele de autentificare ale portalului (e-mail și parolă):
      • Permit accesul la mai multe organizații.
   2. Cheie API și secret:
      • De obicei, sunt asociate unui distributor sau unei organizații specifice.
3. Faceți clic pe „Autorizează”

Acum sunteți autorizat să testați și să începeți să utilizați fiscalizarea în Cloud.

Acest articol a fost tradus automat.