Получить полный API Key
GET /api/open/v1/keys/:id/keyВозвращает тот же объект Key, что и Получить API Key, но в поле key находится полное значение sk-..., а не маска. Используйте этот эндпоинт, когда сторонней интеграции нужно сохранить или ротировать Key без просьбы к пользователю скопировать значение из консоли.
Параметры запроса
Section titled “Параметры запроса”| Параметр | Где | Тип | Обязательный | Описание |
|---|---|---|---|---|
id | path | integer | Да | ID Key, положительное целое число |
Пример запроса
Section titled “Пример запроса”curl https://www.routeapi.ai/api/open/v1/keys/12/key \ -H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY"Пример ответа
Section titled “Пример ответа”{ "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.
Ошибки
Section titled “Ошибки”| HTTP | code | Сценарий |
|---|---|---|
| 400 | invalid_request | id не является положительным целым числом |
| 403 | insufficient_scope | У Management Key нет разрешения, необходимого для этого эндпоинта |
| 404 | not_found | Key не существует или не принадлежит вам |
| 429 | rate_limited | Превышен лимит запросов на Management Key |
| 429 | — | Превышен лимит запросов на IP клиента (по умолчанию 100 запросов/20 минут для чувствительных эндпоинтов); тело ответа может быть пустым |
Прочие общие коды ошибок см. в Ошибки и лимиты.
Примечания
Section titled “Примечания”- Каждый успешный вызов записывает событие аудита (
open_api.key.reveal) с ID и именем Key и использованным Management Key. Незамаскированные Key никогда не попадают в аудит или логи. - К этому эндпоинту применяется более строгое ограничение частоты, чем к обычным эндпоинтам чтения, поскольку он возвращает секреты.
- Полный Key также один раз возвращается при создании API Key. Предпочитайте сохранять его при создании и вызывайте этот эндпоинт только если сохранённое значение потеряно или требует ротации.
- Получить API Key и Список API Key по-прежнему возвращают маскированное значение.