RetailForce Cloud API

RetailForce Cloud API пружа све функције Cloud портала. Може се користити за аутоматизацију процеса или за позивање функција из спољних система без пријављивања на портал и ручног обављања активности.

Аутентификација

Да би користио функције, захтевајући систем мора да се аутентикује у облачном систему. У наставку су описане ручна аутентикација као и примери позива заснованих на догађајима.

Приступ преко api.retailForce.cloud

Cloud API је доступан на следећем URL-у:

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

Ручна аутентификација

Аутентификација се врши преко CloudApiKey и CloudApiSecret и генерисањем Bearer токена.

1. Позовите крајњу тачку

1. Кликните на крајњу тачку POST /api/v1.0/authenticate/logon да бисте проширили одељак.
2. Унесите свој apiKey и apiKeySecret у одговарајућа поља.
3. Покрените захтев да бисте добили Bearer токен.

2. Користите Bearer токен

1. Копирајте Bearer токен из ResponseBody.
2. Кликните на дугме "Authorize" у горњем десном углу Swagger корисничког интерфејса.
3. Унесите Bearer токен у дијалошки оквир. Формат: Bearer <token> (убаците размак после "Bearer").
4. Кликните на "Authorize"

Аутоматска аутентификација

Аутоматска аутентикација омогућава системима безбедан приступ RetailForce Cloud API-ју без корисничког учешћа, идеално за позадинске услуге, аутоматизоване токове рада или редовне упите података.

1. Аутентификација и добијање бејрер токена:

Пошаљите POST захтев са својим API акредитивама на ендпоинт за аутентификацију.

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

Након успешне аутентификације, добићете Bearer токен у ResponseBody, који је потребан за ауторизацију даљих API захтева.

2. Приступ ендпоинтима:

Користите примљени Bearer токен за приступ ендпоинтима.

Пример:

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

Важно: Чувајте своје API акредитиве и токене на сигурном да бисте спречили неовлашћен приступ.

Облачна фискализација

"Cloud Fiscalization" се односи на пружање RetailForce middleware-а за фискализацију као хостоване облачне услуге. Услугу у облачном окружењу оперативно обезбеђује RetailForce.

Приступ преко fiscalisation.retailforce.cloud

Приступите услузи преко следећег линка:

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

Ручна аутентификација

Постоје две опције за аутентификацију у RetailForce Cloud Fiscalization преко Swagger UI:

1. Отворите Swagger UI и кликните на "Authorize".
2. Методе аутентификације
   1. Кредицијали за портал (имејл и лозинка):
      • Дозвољава приступ више организација.
   2. API кључ и тајна:
      • Обично је повезан са одређеним дистрибутером или организацијом.
3. Кликните на "Овлашћивање"

Сада сте овлашћени да тестирате и започнете коришћење облачне фискализације.

Овај чланак је аутоматски преведен.