Сменить секрет подписи Webhook

POST

/api/v1/webhook/rotate-secret

Для пользователей из материкового Китая: используйте https://api.toapis.cn в качестве эндпоинта (Base URL). Замените https://api.toapis.com на https://api.toapis.cn во всех примерах этого документа.

Поведение

Генерирует или заменяет секрет подписи указанного ключа — получатель проверяет им подписи колбэков. Сама ротация колбэки не включает. secret возвращается только один раз в этом ответе, GET его не перевыпускает — при потере ротируйте снова.

Прежний секрет остаётся действителен 24 часа для переходного периода проверки. Слот старого секрета один, последовательные ротации его заменяют.

Запись запрещена для удаленных ключей и ключей со scope. Отключенные, просроченные и исчерпанные ключи можно настраивать. Ограничение частоты общее с операциями записи жизненного цикла ключей: не более 10 запросов на запись в минуту на пользователя.

JSON не более 16384 байт, чтение тела не более 10 секунд. Параметры запроса, неизвестные и повторяющиеся поля JSON запрещены. Api_key_id обязателен.

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

Authorizationstringзаголовокобязательно

Используйте системный токен Bearer YOUR_SYSTEM_ACCESS_TOKEN. Доступ ограничен вашим аккаунтом. Ключи моделей не принимаются. X-User-Id не нужен. Обхода через права администратора или команды нет.

Параметры запроса

api_key_idintegerтелообязательно

Положительный целочисленный ID собственного обычного ключа модели, не секрет sk- и не токен доступа. В JSON требуется целое число; строки, null, пропуск и параметры запроса отклоняются.

Недопустимый api_key_id — 400; отсутствующий или чужой ключ — 404; управление секретами при mode=off — 409 (code=16016); при лимите — 429.

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

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

curl --request POST \
  --url 'https://api.toapis.com/api/v1/webhook/rotate-secret' \
  --header 'Authorization: Bearer YOUR_SYSTEM_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"api_key_id":123}'

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

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

{
  "code": 0,
  "message": "",
  "data": {
    "api_key_id": 123,
    "secret": "0000000000000000000000000000000000000000000000000000000000000000",
    "previous_secret_expires_at": null
  }
}

Порядок подключения и проверку подписи см. в Получить настройки Webhook.