REST API
POST/ api/ v1/ keys/ { id} / rotate
Атомарно отозвать существующий ключ и выдать новый с тем же именем и scopes на 90 дней.
| Поле | Значение |
|---|---|
| URL | POST |
| Доступ | Cookie кабинета |
| Scope для ключей | ключи не принимаются – только кабинет (403 CREDENTIAL_) |
| Свежий вход | не старше 10 минут |
| operationId | keysRotate |
Описание#
Атомарно отозвать существующий ключ и выдать новый с тем же именем и scopes на 90 дней. Новый secret показывается один раз. Истёкший неотозванный ключ также можно заменить.
Auth: сессия кабинета (cookie). Fresh auth ≤10 минут. Scope: не требуется.
Path (обязателен каждый параметр):
| Поле | Тип | Обязательно | Ограничения |
|---|---|---|---|
id | string | да | формат "uuid"; pattern см. полную схему |
Query: нет объявленных полей.
Body: не требуется.
Ответ · статус и структура
Ответ: 200 application/, ApiKeyCreated.
Краткая форма: {.
Пример JSON; значения демонстрационные.
{
"key": {
"id": "5b8c3e4a-1d6f-4a91-8c3d-4e5f6a7b8c9d",
"name": "MacBook · Claude Code",
"prefix": "aos3.sk_EXAMPL",
"scopes": [
"course:read",
"profile:read"
],
"createdAt": "2027-02-01T10:00:00Z",
"expiresAt": "2027-05-02T10:00:00Z",
"lastUsedAt": null,
"revokedAt": null,
"status": "active"
},
"secret": "aos3.sk_EXAMPLE_rotated-not-real_0123456789abcdefgh"
}Ошибки: 401 , 403 , 503 , 429 , 403 , 422 , 403 , 401 , 404 , 409 , 429 ; общие ошибки.
Лимиты: Те же ограничения создания: до 3 активных и 10 созданий/день МСК; заменяемый ключ не занимает дополнительный слот.
curl -sS -i -X POST https://aos.edgelab.space/api/v1/keys/00000000-0000-4000-8000-000000000001/rotate \
--cookie '__Host-aos_sess=SESSION_PLACEHOLDER' \
-H 'Origin: https://aos.edgelab.space'Ответы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | application/json | ApiKeyCreated | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, ORIGIN_REJECTED, VALIDATION_FAILED, CREDENTIAL_NOT_ALLOWED, REAUTH_REQUIRED, NOT_FOUND, KEY_LIMIT, KEY_RATE |
Машиночитаемый контракт: openapi.json, операция keysRotate.