LOKO Merchant API
  • Getting Started
    • 🔌Процес інтеграції
    • 💂Отримання токену
    • 🪃Опрацювання Callback(Webhook)
  • General Terms & Conditions
    • 🔓Scope
    • ⚙️Environment
    • 🔑Company & Store
  • API Reference
    • Orders
    • Stores
    • Menu
      • Separate Product & Offer
      • Common Product + Offer (deprecated)
      • Common Menu Import
      • Stop-list
      • Import categories
    • Callbacks (webhooks)
Powered by GitBook
On this page
  1. Getting Started

Отримання токену

❓ Як отримати токен для використання API

PreviousПроцес інтеграціїNextОпрацювання Callback(Webhook)

Last updated 1 year ago

Список доступних адрес для використання з необхідним оточенням 👈

Зверніть увагу:{client_id}та {client_secret}потрібно замінити на ваш client id та ваш client secret.

  1. Використовуємо запит на автентифікацію з client id та client secret:

curl --location 'https://{IDENTITY_SERVICE_API_URI}/connect/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id={client_id}' \
--data-urlencode 'client_secret={client_secret}'
  1. Виконуємо запит і отримуємо відповідь.

Якщо запит був виконаний успішно, ви отримаєте у відповідь подібний JSON.

  • access_token – це токен, який необхідно зберегти на час, який вказаний у expires_in;

  • token_type – тип токену, який треба буде вказати під час авторизації, коли виконуються запити;

  • expires_in – час життя токену в секундах, який розраховується від моменту отримання токену;

  • scope – список ідентифікаторів зон доступу в межах API. 👈

Токен не буде працювати після закінчення терміну дії, зазначеного у полі expires_in, тому вам необхідно буде отримати авторизаційний токен знову та зберегти його.

{
    "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjhFNTYzQTUyMUYxQUQ5OUYzN0ExOEU4RDIyM0RDMTU0NERDNDhGMDZSUzI1NiIsInR5cCI6ImF0K2p3dCIsIng1dCI6ImpsWTZVaDhhMlo4M29ZNk5JajNCVkUzRWp3WSJ9.eyJuYmYiOjE3MTE2MzQwNzQsImV4cCI6MTcxMTYzNzY3NCwiaXNzIjoiaHR0cHM6Ly9pZGVudGl0eS1wdWJsaWMtcWEuZm9vZHRlY2gudGVhbSIsImNsaWVudF9pZCI6Im1lcmNoYW50LS1xYS1hdXRvbWF0aW9uIiwianRpIjoiMUI0OUE4M0M3MEMxMUQ2MkU4NjYxMEIwNTVBRjBBRjEiLCJpYXQiOjE3MTE2MzQwNzQsInNjb3BlIjpbImNvcmUtLWNvcmUtLWltcG9ydC1zZXJ2aWNlOmltcG9ydC0tc3RhcnQiLCJjb3JlLS1jb3JlLS1vZmZlci1zZXJ2aWNlOm9mZmVyLS1zdGF0dXMtdXBkYXRlIiwibWVyY2hhbnQtLWNvcmUtLWludGVncmF0aW9uLXNlcnZpY2U6YnJhbmNoLS1wYXVzZSIsIm1lcmNoYW50LS1jb3JlLS1vcmRlci1zZXJ2aWNlOm9yZGVyLS1jb3VyaWVyLWFzc2lnbiIsIm1lcmNoYW50LS1jb3JlLS1vcmRlci1zZXJ2aWNlOm9yZGVyLS1jcmVhdGUiLCJtZXJjaGFudC0tY29yZS0tb3JkZXItc2VydmljZTpvcmRlci0tZGVsZXRlIiwibWVyY2hhbnQtLWNvcmUtLW9yZGVyLXNlcnZpY2U6b3JkZXItLWdldCIsIm1lcmNoYW50LS1jb3JlLS1vcmRlci1zZXJ2aWNlOm9yZGVyLS1nZXQtbGlzdCIsIm1lcmNoYW50LS1jb3JlLS1vcmRlci1zZXJ2aWNlOm9yZGVyLS1pdGVtLWNoYW5nZSIsIm1lcmNoYW50LS1jb3JlLS1vcmRlci1zZXJ2aWNlOm9yZGVyLS1yZWZ1bmQiLCJtZXJjaGFudC0tY29yZS0tb3JkZXItc2VydmljZTpvcmRlci0tc3RhdHVzLWNoYW5nZSJdfQ.rsOCPArKaNhqFlfTUEAYzJChxK4md8eB345-Nx_153rXGrEhNpVnPy1tzJG_6un6Jz7ha8AN5kdHUzF2IQv2rTl5D2r2l6ps5qSucXU8B4u0sZG-Un5w9EysPH5riplGH-5Igx8HPXia7PG2M-egyb-KPmYx5_wjCytMOW-88UIPMaXMERmLqvC0cKl1poyifDyveb93AixUaueI2IlrpiGCBNFE5UJO6IPf3auZXOp1WN_Q_BEK55BhNCj-n4i38BN4g9f8k0OAGjtNi9bZbZO_wlBcJ8jrCww0SmFk-ssol862JmqW7gC9a8MwVXHIZHMODebWQfs7Vr7G1BtWMw",
    "expires_in": 3600,
    "token_type": "Bearer",
    "scope": "core--core--import-service:import--start core--core--offer-service:offer--status-update merchant--core--integration-service:branch--pause merchant--core--order-service:order--courier-assign merchant--core--order-service:order--create merchant--core--order-service:order--delete merchant--core--order-service:order--get merchant--core--order-service:order--get-list merchant--core--order-service:order--item-change merchant--core--order-service:order--refund merchant--core--order-service:order--status-change"
}
  1. Використовуємо токен в усіх наступних запитах.

curl -X GET https://{PLATFORM_SERVICE_API_URI}/v1/merchant/orders \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjhFNTYzQTUyMUYxQUQ5OUYzN0ExOEU4RDIyM0RDMTU0NERDNDhGMDZSUzI1NiIsInR5cCI6ImF0K2p3dCIsIng1dCI6ImpsWTZVaDhhMlo4M29ZNk5JajNCVkUzRWp3WSJ9.eyJuYmYiOjE3MTE2MzQwNzQsImV4cCI6MTcxMTYzNzY3NCwiaXNzIjoiaHR0cHM6Ly9pZGVudGl0eS1wdWJsaWMtcWEuZm9vZHRlY2gudGVhbSIsImNsaWVudF9pZCI6Im1lcmNoYW50LS1xYS1hdXRvbWF0aW9uIiwianRpIjoiMUI0OUE4M0M3MEMxMUQ2MkU4NjYxMEIwNTVBRjBBRjEiLCJpYXQiOjE3MTE2MzQwNzQsInNjb3BlIjpbImNvcmUtLWNvcmUtLWltcG9ydC1zZXJ2aWNlOmltcG9ydC0tc3RhcnQiLCJjb3JlLS1jb3JlLS1vZmZlci1zZXJ2aWNlOm9mZmVyLS1zdGF0dXMtdXBkYXRlIiwibWVyY2hhbnQtLWNvcmUtLWludGVncmF0aW9uLXNlcnZpY2U6YnJhbmNoLS1wYXVzZSIsIm1lcmNoYW50LS1jb3JlLS1vcmRlci1zZXJ2aWNlOm9yZGVyLS1jb3VyaWVyLWFzc2lnbiIsIm1lcmNoYW50LS1jb3JlLS1vcmRlci1zZXJ2aWNlOm9yZGVyLS1jcmVhdGUiLCJtZXJjaGFudC0tY29yZS0tb3JkZXItc2VydmljZTpvcmRlci0tZGVsZXRlIiwibWVyY2hhbnQtLWNvcmUtLW9yZGVyLXNlcnZpY2U6b3JkZXItLWdldCIsIm1lcmNoYW50LS1jb3JlLS1vcmRlci1zZXJ2aWNlOm9yZGVyLS1nZXQtbGlzdCIsIm1lcmNoYW50LS1jb3JlLS1vcmRlci1zZXJ2aWNlOm9yZGVyLS1pdGVtLWNoYW5nZSIsIm1lcmNoYW50LS1jb3JlLS1vcmRlci1zZXJ2aWNlOm9yZGVyLS1yZWZ1bmQiLCJtZXJjaGFudC0tY29yZS0tb3JkZXItc2VydmljZTpvcmRlci0tc3RhdHVzLWNoYW5nZSJdfQ.rsOCPArKaNhqFlfTUEAYzJChxK4md8eB345-Nx_153rXGrEhNpVnPy1tzJG_6un6Jz7ha8AN5kdHUzF2IQv2rTl5D2r2l6ps5qSucXU8B4u0sZG-Un5w9EysPH5riplGH-5Igx8HPXia7PG2M-egyb-KPmYx5_wjCytMOW-88UIPMaXMERmLqvC0cKl1poyifDyveb93AixUaueI2IlrpiGCBNFE5UJO6IPf3auZXOp1WN_Q_BEK55BhNCj-n4i38BN4g9f8k0OAGjtNi9bZbZO_wlBcJ8jrCww0SmFk-ssol862JmqW7gC9a8MwVXHIZHMODebWQfs7Vr7G1BtWMw' \
  -H 'Accept: application/json'

Приклад неуспішної відповіді з використанням токену, термін дії якого закінчився 👇

{"message":"jwt expired"}

Приклад з отриманим раніше токеном 👇

💂
можна знайти тут
Дізнатися детальніше про scope
запиту на отримання списку замовлень