Автентифікація

Що це

Кожен запит несе ключ як bearer-токен:

Authorization: Bearer ds_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Є рівно два scope: read (завжди присутній на будь-якому ключі) і write (створювати пости, завантажувати медіа, повторювати, скасовувати). Маршрут, якому потрібен write, на ключі лише з read відповідає 403 insufficient_scope.

Ключ і сесія разом

Надсилання ключа API і cookie сесії браузера з входом в одному запиті відхиляється як key_and_session (401), а не мовчки обирає один із них — неоднозначний credential вважається відсутнім.

Типові помилки

Помилка	Причина	Що робити
unauthenticated	Не надіслано ні ключ, ні сесію, або ключ недійсний/відкликаний.	Надішліть дійсний ключ у заголовку Authorization.
insufficient_scope	Ключу бракує scope, потрібного маршруту.	Створіть ключ зі write або використовуйте цей лише для маршрутів читання.
key_and_session	В одному запиті надіслано і ключ, і cookie сесії.	Надсилайте лише одне — ключ для скрипта чи інтеграції, сесію для браузера.