RetailForce Cloud API

RetailForce Cloud API ponuja vse funkcije RetailForce Cloud Portal. Uporablja se lahko za avtomatizacijo procesov ali za klic funkcij iz zunanjih sistemov, ne da bi se bilo treba prijaviti v portal in dejavnosti izvajati ročno.

Preverjanje pristnosti

Za uporabo funkcij se mora sistem, ki pošilja zahtevo, avtentificirati v Cloud sistemu. V nadaljevanju je opisana ročna avtentifikacija ter primeri klicov, ki jih sprožijo dogodki.

Dostop prek api.retailForce.cloud

Cloud API je na voljo na naslednjem URL-ju:

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

Ročna avtentifikacija

Avtentifikacija se izvede prek cloudApiKey in cloudApiSecret ter z ustvarjanjem Bearer Token.

1. Končna točka

1. Kliknite na končno točko POST /api/v1.0/authenticate/logon, da razširite ta razdelek.
2. V ustrezna polja vnesite svoj apiKey in apiKeySecret.
3. Izvedite zahtevo, da prejmete Bearer Token.

2. Uporaba Bearer Tokena

1. Kopirajte Bearer Token iz ResponseBody.
2. Kliknite gumb »Authorize« v zgornjem desnem kotu Swagger UI.
3. V pogovorno okno vnesite Bearer Token. Oblika: Bearer <token> (vstavite presledek za »Bearer«).
4. Kliknite »Authorize«

Avtomatska avtentifikacija

Avtomatska avtentifikacija omogoča sistemom varen dostop do RetailForce Cloud API brez posredovanja uporabnika, kar je idealno za storitve v ozadju, avtomatizirane delovne tokove ali redna poizvedovanja podatkov.

1. Avtentifikacija in prejem žetona Bearer:

Pošljite zahtevo POST s svojimi poverilnicami api na končno točko avtentifikacije.

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 uspešni avtentifikaciji boste v ResponseBody prejeli Bearer Token, ki je potreben za avtorizacijo nadaljnjih zahtev api.

2. Dostop do končnih točk:

Prejeti Bearer Token uporabite za dostop do končnih točk.

Primer:

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

Pomembno: Svoje api-pristojnosti in žetone hranite na varnem, da preprečite nepooblaščen dostop.

Fiskalizacija v oblaku

»Fiskalizacija v oblaku« se nanaša na zagotavljanje fiskalizacijskega middlewareja RetailForce kot gostovane storitve v oblaku. Storitev v oblačnem okolju upravlja podjetje RetailForce.

Dostop prek fiscalisation.retailforce.cloud

Do storitve dostopate prek naslednje povezave:

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

Ročna avtentifikacija

Za avtentifikacijo v storitvi RetailForce Cloud Fiscalization prek Swagger UI sta na voljo dve možnosti:

1. Odprite Swagger UI in kliknite na »Authorize«.
2. Načini avtentifikacije
   1. Pristojnosti za portal (e-pošta in geslo):
      • Omogočajo dostop do več organizacij.
   2. API ključ in API Secret:
      • Običajno sta povezana z določenim distributorjem ali organizacijo.
3. Kliknite »Avtoriziraj«

Sedaj ste pooblaščeni za testiranje in začetek uporabe oblačne fiskalizacije.

Ta članek je bil samodejno preveden.