Аутентификация API

Как аутентифицироваться в REST API Emailist

Обзор

Emailist использует Clerk для аутентификации. API требует аутентификации для большинства операций. Аутентификация выполняется через токены, передаваемые в заголовках запросов.

Получение токена

Через Clerk

Токен получается через Clerk после успешной аутентификации пользователя. Токен передаётся в заголовке Authorization.

Использование токена

Заголовок Authorization

Все запросы к API должны включать заголовок:

Authorization: Bearer <your-token>

Пример запроса

curl -X GET https://api.emailist.ru/api/templates \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"

Endpoints аутентификации

GET /api/auth/me

Получить информацию о текущем аутентифицированном пользователе.

Ответ:

{
  "user": {
    "id": "user_xxx",
    "email": "user@example.com",
    "firstName": "John",
    "lastName": "Doe"
  }
}

POST /api/auth/webhook

Webhook от Clerk для синхронизации пользователей. Используется внутренне системой.

Обработка ошибок

401 Unauthorized

Токен отсутствует, недействителен или истёк:

{
  "statusCode": 401,
  "message": "Unauthorized"
}

403 Forbidden

Пользователь аутентифицирован, но не имеет доступа к ресурсу:

{
  "statusCode": 403,
  "message": "Forbidden"
}