Автентифікація
Кожен запит до API містить API-ключ. Запити ніколи не прив’язуються до сесії браузера.
Створення API-ключа
Створюйте ключі в розділі API-ключі свого акаунта, не більше 5. Поки ви ввійшли в акаунт, ключ можна будь-коли скопіювати на цій сторінці: ми зберігаємо його в зашифрованому вигляді й показуємо лише вам. Тримайте його в таємниці, як пароль, а якщо він міг бути розкритий, відкличте його й створіть новий.
Передавання API-ключа
Передавайте його в заголовку Authorization як Bearer, а потім сам ключ. X-API-Key теж працює.
curl "https://api.talismanleads.io/v1/account" \
-H "Authorization: Bearer tl_live_your_key_here"Що може API-ключ
Новий API-ключ може все: бачити ваш баланс, перевірки, ваші замовлення та їхні результати, а також використовувати POST /uploads, POST /estimates і POST /orders, які зберігають ваш список або витрачають ваш баланс. Ключ, створений до 8 листопада 2026 року, може бути лише для читання: він бачить усе, але ці три виклики відхиляють його з кодом missing_scope.
Термін дії та IP-адреси
Термін дії нового API-ключа не спливає, і він працює з будь-якої адреси. Ключ, створений до 8 листопада 2026 року, може мати термін дії, після якого він відхиляється з кодом expired_key, або бути обмеженим IP-адресами вашого сервера, тож запит із будь-якого іншого місця відхиляється з кодом ip_not_allowed. Щоб змінити будь-що з цього, створіть новий ключ і відкличте старий.
Безпека API-ключа
- Ставтеся до API-ключа як до пароля: будь-хто, у кого він є, може витратити ваш баланс.
- Використовуйте його лише на своєму сервері. API не дозволяє виклики з вебсторінки.
- Не зберігайте його в коді та в системі контролю версій.
- Якщо ключ міг бути розкритий, негайно відкличте його у своєму акаунті. Він одразу перестане працювати. Уже розміщені замовлення продовжать виконуватися.
- Надсилайте його лише до API. Посилання для завантаження на сервер і скачування мають власний дозвіл, тому не надсилайте на них свій API-ключ.
Коли API-ключ відхилено
На неправильний, відкликаний або прострочений ключ надходить відповідь 401. На заблокований ключ або акаунт надходить відповідь 403. Див. Помилки.