Skip to content

Получить полный API Key

GET /api/open/v1/keys/:id/key

Возвращает тот же объект Key, что и Получить API Key, но в поле key находится полное значение sk-..., а не маска. Используйте этот эндпоинт, когда сторонней интеграции нужно сохранить или ротировать Key без просьбы к пользователю скопировать значение из консоли.

ПараметрГдеТипОбязательныйОписание
idpathintegerДаID Key, положительное целое число
Terminal window
curl https://www.routeapi.ai/api/open/v1/keys/12/key \
-H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY"
{
"success": true,
"message": "",
"data": {
"id": 12,
"name": "bot",
"key": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"status": 1,
"created_time": 1729000000,
"accessed_time": 1729000000,
"expired_time": -1,
"remain_amount": 10.00,
"unlimited": false,
"used_amount": 0.00,
"model_limits_enabled": false,
"model_limits": "",
"allow_ips": ""
}
}

Ответ содержит заголовок Cache-Control: no-store, поэтому ни браузеры, ни прокси не кэшируют Key в открытом виде. Описание полей см. в Объект Key.

HTTPcodeСценарий
400invalid_requestid не является положительным целым числом
403insufficient_scopeУ Management Key нет разрешения, необходимого для этого эндпоинта
404not_foundKey не существует или не принадлежит вам
429rate_limitedПревышен лимит запросов на Management Key
429—Превышен лимит запросов на IP клиента (по умолчанию 100 запросов/20 минут для чувствительных эндпоинтов); тело ответа может быть пустым

Прочие общие коды ошибок см. в Ошибки и лимиты.

  • Каждый успешный вызов записывает событие аудита (open_api.key.reveal) с ID и именем Key и использованным Management Key. Незамаскированные Key никогда не попадают в аудит или логи.
  • К этому эндпоинту применяется более строгое ограничение частоты, чем к обычным эндпоинтам чтения, поскольку он возвращает секреты.
  • Полный Key также один раз возвращается при создании API Key. Предпочитайте сохранять его при создании и вызывайте этот эндпоинт только если сохранённое значение потеряно или требует ротации.
  • Получить API Key и Список API Key по-прежнему возвращают маскированное значение.