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

Для доступа к API v2 необходим API токен. Токен передается в заголовке X-API-Token.

Важно

API токен показывается только один раз при создании. Сохраните его в надежном месте.

Создание API токена

POST /tokens

Создаёт новый API токен для доступа к API. Требуется авторизация.

Тело запроса

Поле Тип Обязательный Описание
name string Да Название токена (1-100 символов)

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

cURL 
curl -X POST "https://zakupki.fraim.ru/api/v2/tokens" \
  -H "Content-Type: application/json" \
  -H "Cookie: session=your_session_cookie" \
  -d '{"name": "Production API Key"}'

Пример ответа

JSON 201 Created 
{
  "id": 1,
  "name": "Production API Key",
  "token": "fraim_v2_abc123xyz789...",
  "created_at": "2024-01-15T10:30:00"
}

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

Передайте токен в заголовке X-API-Token во всех запросах:

cURL 
curl -X GET "https://zakupki.fraim.ru/api/v2/tenders?filter_id=123" \
  -H "X-API-Token: fraim_v2_abc123xyz789..."

Список токенов

GET /tokens

Возвращает список всех API токенов пользователя (без самих токенов).

Пример ответа

JSON 200 OK 
{
  "tokens": [
    {
      "id": 1,
      "name": "Production API Key",
      "token_preview": "fraim...xyz",
      "is_active": true,
      "created_at": "2024-01-15T10:30:00",
      "last_used_at": "2024-01-20T14:22:10"
    }
  ],
  "total": 1
}

Удаление токена

DELETE /tokens/{id}

Удаляет указанный API токен. После удаления токен перестаёт работать.

Параметры пути

Параметр Тип Описание
id integer ID токена

Пример ответа

JSON 200 OK 
{
  "success": true,
  "message": "Токен успешно удален"
}