RetailForce Cloud API

RetailForce Cloud API tillhandahåller alla funktioner i RetailForce Cloud Portal. Detta kan användas för att automatisera processer eller för att anropa funktioner från externa system utan att logga in på portalen och utföra aktiviteter manuellt.

Autentisering

För att kunna använda funktionerna måste det begärande systemet autentisera sig hos Cloud-systemet. Nedan beskrivs manuell autentisering samt exempel på händelsestyrda anrop.

Åtkomst via api.retailForce.cloud

Cloud API är tillgängligt på följande URL:

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

Manuell autentisering

Autentiseringen sker via cloudApiKey och cloudApiSecret samt genom generering av en Bearer-token.

1. Anropa slutpunkt

1. Klicka på slutpunkten POST /api/v1.0/authenticate/logon för att expandera avsnittet.
2. Ange din apiKey och apiKeySecret i motsvarande fält.
3. Skicka begäran för att få ett Bearer-token.

2. Använd Bearer-token

1. Kopiera Bearer-token från ResponseBody.
2. Klicka på knappen ”Authorize” längst upp till höger i Swagger UI.
3. Ange Bearer-token i dialogrutan. Format: Bearer <token> (infoga ett mellanslag efter ”Bearer”).
4. Klicka på ”Authorize”

Automatisk autentisering

Automatisk autentisering gör det möjligt för system att säkert komma åt RetailForce Cloud API utan användarinteraktion, vilket är idealiskt för bakgrundstjänster, automatiserade arbetsflöden eller regelbundna dataförfrågningar.

1. Autentisering och mottagande av Bearer-token:

Skicka en POST-begäran med dina api-inloggningsuppgifter till autentiseringsändpunkten.

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

När autentiseringen har genomförts framgångsrikt får du ett Bearer-token i ResponseBody, vilket krävs för att auktorisera ytterligare api-förfrågningar.

2. Åtkomst till slutpunkter:

Använd det mottagna Bearer-tokenet för att få åtkomst till slutpunkter.

Exempel:

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

Viktigt: Förvara dina api-inloggningsuppgifter och token på ett säkert sätt för att förhindra obehörig åtkomst.

Cloud fiscalisering

”Cloud Fiscalization” avser tillhandahållandet av RetailForce-fiskaliseringsmiddleware som en molnbaserad tjänst. Tjänsten drivs av RetailForce i molnmiljön.

Åtkomst via fiscalisation.RetailForce Cloud

Gå till tjänsten via följande länk:

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

Manuell autentisering

Det finns två alternativ för autentisering till RetailForce Cloud Fiscalization via Swagger UI:

1. Öppna Swagger UI och klicka på ”Authorize”.
2. Autentiseringsmetoder
   1. Inloggningsuppgifter för portalen (e-postadress och lösenord):
      • Ger åtkomst till flera organisationer.
   2. API-nyckel och API Secret:
      • Vanligtvis kopplade till en specifik distributor eller organisation.
3. Klicka på ”Auktorisera”

Du är nu auktoriserad att testa och börja använda molnbaserad skattehantering.

Den här artikeln har översatts automatiskt.