SHVYDKO / API
Ключі та автентифікація
Організаційні API-ключі для сервера, одноразовий показ секрету й відкликання доступу.
Створення ключа
Власник або адміністратор відкриває API Keys у потрібній організації та задає зрозумілу назву: наприклад, support-staging. Секрет показується один раз. У списку залишаються назва й префікс для розпізнавання.
Ключ належить організації: її баланс, обмеження й Usage застосовуються до всіх її ключів. Вибір іншої організації в кабінеті не переносить уже створений ключ.
Передавання ключа
Викликайте API з довіреного сервера. Не використовуйте публічні змінні NEXT_PUBLIC_ для секрету й не зберігайте його в localStorage. Для браузерного застосунку створіть власний серверний endpoint із перевіркою користувача.
Зовнішні /v1 endpoints використовують Bearer-ключ. Cookie-сесія кабінету та його заголовок активної організації не потрібні для інтеграції через /v1.
Authorization: Bearer <SHVYDKO_API_KEY>Ротація та відкликання
Відкликаний, невідомий або відсутній ключ повертає HTTP 401. Не записуйте Authorization у логи й не додавайте його до звернення щодо помилки.
- Створіть новий ключ і оновіть секрет у своєму серверному середовищі.
- Перевірте запит до GET /v1/models із новим ключем.
- Відкличте старий ключ у кабінеті.
- У разі витоку відкличте ключ одразу; повторне читання його повного значення неможливе.