RetailForce Cloud API

RetailForce Cloud API tilbyder alle funktionerne i RetailForce Cloud Portal. Dette kan bruges til at automatisere processer eller til at kalde funktioner fra eksterne systemer uden at logge ind på portalen og udføre aktiviteter manuelt.

Godkendelse

For at kunne benytte funktionerne skal det anmodende system autentificere sig over for Cloud-systemet. I det følgende beskrives manuel autentificering samt eksempler på begivenhedsstyrede opkald.

Adgang via RetailForce Cloud API

Cloud API'et er tilgængeligt på følgende URL:

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

Manuel autentificering

Autentificering sker via cloudApiKey og cloudApiSecret samt generering af et Bearer-token.

1. Endpoint

1. Klik på endpointet POST /api/v1.0/authenticate/logon for at udvide afsnittet.
2. Indtast din apiKey og apiKeySecret i de tilhørende felter.
3. Udfør anmodningen for at modtage et Bearer-token.

2. Brug af Bearer-token

1. Kopier Bearer-tokenet fra ResponseBody.
2. Klik på knappen "Authorize" øverst til højre i Swagger UI.
3. Indtast Bearer-tokenet i dialogboksen. Format: Bearer <token> (indsæt et mellemrum efter "Bearer").
4. Klik på "Authorize"

Automatisk godkendelse

Automatisk godkendelse giver systemer mulighed for sikkert at få adgang til RetailForce Cloud API uden brugerindgriben, hvilket er ideelt til baggrundstjenester, automatiserede arbejdsgange eller regelmæssige dataforespørgsler.

1. Godkendelse og modtagelse af Bearer-token:

Send en POST-anmodning med dine api-legitimationsoplysninger til godkendelsesendepunktet.

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 godkendelsen er gennemført, modtager du et Bearer-token i ResponseBody, som er nødvendigt for at godkende yderligere api-anmodninger.

2. Adgang til endpoints:

Brug det modtagne Bearer-token til at få adgang til endpoints.

Eksempel:

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

Vigtigt: Opbevar dine api-adgangskoder og tokens sikkert for at forhindre uautoriseret adgang.

Cloud-fiskalisering

"Cloud-fiskalisering" henviser til levering af RetailForce Middleware som en hostet cloud-tjeneste. Tjenesten drives af RetailForce i cloud-miljøet.

Adgang via fiscalisation.RetailForce Cloud

Få adgang til tjenesten via følgende link:

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

Manuel autentificering

Der er to muligheder for godkendelse til RetailForce Cloud Fiscalization via Swagger UI:

1. Åbn Swagger UI og klik på "Authorize".
2. Godkendelsesmetoder
   1. Portaloplysninger (e-mail og adgangskode):
      • Giver adgang til flere organisationer.
   2. API-nøgle og API Secret:
      • Er typisk knyttet til en bestemt distributor eller organisation.
3. Klik på "Godkend"

Du er nu autoriseret til at teste og begynde at bruge Cloud-fiskaliseringen.

Denne artikel er oversat automatisk.