У цій статті:

• Лише для вашого акаунта BlackSea
  • Генерація токена доступу

Щоб створити додаток для загального використання, вам потрібно налаштувати обробник Redirect URI, який генеруватиме токени доступу для кожного з ваших користувачів. Однак якщо ви хочете користуватися API лише у власному акаунті BlackSea, можна згенерувати токен доступу вручну — це простіший шлях.

Лише для вашого акаунта

Якщо ви пишете власний код, який має працювати з вашим акаунтом BlackSea, усе, що вам потрібно, — це токен доступу. Токен доступу додається до заголовка кожного запиту до API, і його слід тримати в таємниці, як пароль.

Генерація токена доступу

Спершу увійдіть у свій акаунт BlackSea. Потім перейдіть до розширених налаштувань. Тут ви побачите форму для створення нового додатку.

Заповніть наведені нижче поля та натисніть «Створити додаток»:

• Іконка додатку: невелике зображення, яке ідентифікує ваш додаток.
• Назва додатку: назва вашого додатку.
• Redirect URI: для додатка загального призначення це поле дуже важливе, але якщо вам потрібен лише токен доступу для роботи з власним акаунтом, просто введіть localhost (http://127.0.0.1) — його значення тут не має ваги.

Зберігайте Application ID та Application Secret у безпеці й конфіденційності, але для ручної генерації токена доступу вони не потрібні. Натомість скористайтеся кнопкою «Згенерувати токен доступу».

Тримайте токен доступу в безпеці й таємниці, як пароль. Під час виклику API додавайте його до заголовка запиту. Ось приклад запиту з токеном доступу (замініть ACCESS_TOKEN на рядок із вашого додатку):

curl https://api.blacksea.in.ua/v2/products \
-d "access_token=ACCESS_TOKEN" \
-X GET

Ви завжди можете відредагувати додаток або знову знайти свій токен доступу на сторінці розширених налаштувань.

Хоча під час автентифікації користувача ми також надаємо refresh_token, термін дії access_token не спливає, доки ви не відкличете його вручну.

Маючи токен доступу, поверніться до нашої документації API, щоб переглянути список доступних ендпоінтів.