RetailForce Cloud API

A RetailForce Cloud API a RetailForce Cloud Portal összes funkcióját biztosítja. Ez felhasználható folyamatok automatizálására vagy külső rendszerekből származó funkciók meghívására anélkül, hogy be kellene jelentkezni a portálra és manuálisan elvégezni a műveleteket.

Hitelesítés

A funkciók használatához a kérést kezdeményező rendszernek hitelesítenie kell magát a Cloud-rendszerben. Az alábbiakban ismertetjük a kézi hitelesítést, valamint példákat adunk az eseményvezérelt hívásokra.

Hozzáférés az api.retailForce.cloud oldalon keresztül

A Cloud API a következő URL-címen érhető el:

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

Kézi hitelesítés

A hitelesítés a cloudApiKey és a cloudApiSecret segítségével, valamint egy Bearer Token generálásával történik.

1. Végpont meghívása

1. Kattintson a POST /api/v1.0/authenticate/logon végpontra a szakasz kibontásához.
2. Írja be az apiKey és az apiKeySecret értékeket a megfelelő mezőkbe.
3. Futtassa a kérést a Bearer Token megszerzéséhez.

2. A Bearer Token használata

1. Másolja ki a Bearer Token-t a ResponseBody-ból.
2. Kattintson a Swagger UI jobb felső sarkában található „Authorize” gombra.
3. Írja be a Bearer Token-t a párbeszédpanelen. Formátum: Bearer <token> (a „Bearer” után szóközöt kell beilleszteni).
4. Kattintson az „Authorize” gombra

Automatikus hitelesítés

Az automatikus hitelesítés lehetővé teszi a rendszerek számára, hogy felhasználói beavatkozás nélkül biztonságosan hozzáférjenek a RetailForce Cloud API-hoz, ami ideális háttérszolgáltatásokhoz, automatizált munkafolyamatokhoz vagy rendszeres adatlekérdezésekhez.

1. Hitelesítés és a Bearer Token megszerzése:

Küldjön egy POST kérést az api hitelesítő adataival a hitelesítési végponthoz.

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

A sikeres hitelesítés után a ResponseBody-ban megkapja a Bearer Token-t, amely szükséges a további api-kérelmek engedélyezéséhez.

2. Végpontok elérése:

Használja a kapott Bearer Tokent a végpontok eléréséhez.

Példa:

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

Fontos: Az api-hitelesítő adatait és tokenjeit biztonságosan tárolja, hogy megakadályozza a jogosulatlan hozzáférést.

Cloud-alapú fiskalizáció

A „Cloud-alapú adóügyi megoldás” a RetailForce adóügyi middleware-jének cloud-alapú szolgáltatásként történő nyújtását jelenti. A szolgáltatást a RetailForce üzemelteti a cloud-alapú környezetben.

Hozzáférés a fiscalisation.retailforce.cloud oldalon keresztül

A szolgáltatáshoz a következő linken keresztül férhet hozzá:

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

Kézi hitelesítés

Két lehetőség áll rendelkezésre a RetailForce Cloud Fiscalization szolgáltatásba való bejelentkezéshez a Swagger UI-n keresztül:

1. Nyissa meg a Swagger UI-t, és kattintson az „Authorize” gombra.
2. Hitelesítési módszerek
   1. Portál hitelesítő adatok (e-mail és jelszó):
      • Több szervezethez is hozzáférést biztosít.
   2. API-kulcs és titkos kulcs:
      • Általában egy adott distributorhoz vagy szervezethez kapcsolódik.
3. Kattintson az „Engedélyezés” gombra

Mostantól jogosult a Cloud-alapú adóügyi ellenőrzés tesztelésére és használatára.

Ezt a cikket automatikusan lefordították.