API-ключи

Ключи используются для серверных запросов к Optimize API. Управление ключами доступно в личном кабинете через cookie-сессию.

Передача ключа

Для серверных запросов передавайте ключ только в HTTP-заголовке. Не передавайте ключ в query string и не публикуйте его в браузерном JavaScript.

Authorization: Bearer sk_live_xxx

Список ключей

GET /v1/keys

{
  "items": [{
    "id": "66f...",
    "key": "sk_live_xxx",
    "prefix": "sk_live_xxxxxxxx",
    "name": "production",
    "comment": "site backend",
    "status": "active",
    "has_secret": true,
    "today_used": 12,
    "all_time_used": 340,
    "created_at": "2026-05-16T10:00:00Z"
  }]
}

Старые ключи, созданные до сохранения секрета в кабинете, могут вернуться с has_secret: false. Для них используйте перевыпуск.

Создание ключа

POST /v1/keys

curl -X POST "https://imgfix.ru/v1/keys" \
  -H "Content-Type: application/json" \
  --cookie "sid=..." \
  -d '{ "name": "production", "comment": "site backend" }'

Редактирование, отзыв и перевыпуск

Метод	Назначение	Тело запроса
`PATCH /v1/keys/{id}`	Меняет имя и комментарий.	`{ "name": "...", "comment": "..." }`
`POST /v1/keys/{id}/revoke`	Отзывает активный ключ. Он перестаёт авторизовать запросы.	`{}`
`POST /v1/keys/{id}/reissue`	Отзывает старый ключ и создаёт новый с тем же именем и комментарием.	`{}`

Поля ключа

Поле	Тип	Описание
`key`	string	Полное значение ключа. Возвращается для ключей с сохранённым секретом.
`prefix`	string	Короткий префикс для поиска ключа в списках и логах.
`status`	string	`active` или `revoked`.
`today_used`, `all_time_used`	int	Количество обработанных файлов по ключу.