Авторизация и токены API
Как получить токен API SerpWatch, передать его в заголовке Authorization и что делать, если токен утёк.
Как получить токен
Откройте в кабинете раздел «API» и нажмите «Создать токен». Токен показывается один раз: скопируйте его и сохраните в надёжном месте. Он начинается с sw_. В аккаунте может быть до 10 токенов — например, отдельный для каждой интеграции.
Как передавать
В каждом запросе — заголовок Authorization: Bearer sw_ваш_токен. Токен даёт доступ к проектам вашего аккаунта и к проектам, куда вас пригласили. Права те же, что в интерфейсе: с гостевым доступом «только просмотр» добавлять запросы нельзя.
Если токен утёк
Удалите его в разделе «API» — он перестанет работать сразу — и создайте новый. Мы храним не сам токен, а его хеш, поэтому восстановить старый токен нельзя.
Пример
curl -H "Authorization: Bearer sw_ваш_токен" https://serpwatch.ru/api/v1/projects