REST API
GET/ api/ v1/ keys
История персональных API-ключей: active первыми, затем новые.
| Поле | Значение |
|---|---|
| URL | GET |
| Доступ | Cookie кабинета |
| Scope для ключей | ключи не принимаются – только кабинет (403 CREDENTIAL_) |
| operationId | keysList |
Описание#
История персональных API-ключей: active первыми, затем новые; не более 50, только prefix, scopes и метаданные, без secret. OAuth keys исключены из списка.
Auth: сессия кабинета (cookie). Scope: не требуется.
Path: параметров нет.
Query: нет объявленных полей.
Body: не требуется.
Ответ · статус и структура
Ответ: 200 application/, ApiKeyList.
Краткая форма: {.
Пример JSON; значения демонстрационные.
{
"keys": [
{
"id": "3f6a1c2e-9b4d-4e7f-8a1b-2c3d4e5f6a7b",
"name": "MacBook · Claude Code",
"prefix": "aos3.sk_EXAMPL",
"scopes": [
"course:read",
"profile:read"
],
"createdAt": "2026-11-10T09:00:00Z",
"expiresAt": "2027-02-08T09:00:00Z",
"lastUsedAt": "2026-11-10T09:35:00Z",
"revokedAt": null,
"status": "active"
},
{
"id": "4a7b2d3f-0c5e-4f80-9b2c-3d4e5f6a7b8c",
"name": "Codex",
"prefix": "aos3.sk_q-7_Zr",
"scopes": [
"course:read",
"profile:read",
"progress:write"
],
"createdAt": "2026-11-09T18:00:00Z",
"expiresAt": "2027-02-07T18:00:00Z",
"lastUsedAt": null,
"revokedAt": "2026-11-10T08:30:00Z",
"status": "revoked"
},
{
"id": "5c9d4f51-2e70-4a12-9d4e-5f6a7b8c9d0e",
"name": "Старый ноутбук",
"prefix": "aos3.sk_Xy3_9a",
"scopes": [
"course:read",
"profile:read"
],
"createdAt": "2026-08-01T10:00:00Z",
"expiresAt": "2026-10-30T10:00:00Z",
"lastUsedAt": "2026-10-29T21:14:00Z",
"revokedAt": null,
"status": "expired"
}
]
}Ошибки: 401 , 403 , 503 , 429 , 403 ; общие ошибки.
Лимиты: Отдельного throttle в коде нет.
curl -sS -i https://aos.edgelab.space/api/v1/keys \
--cookie '__Host-aos_sess=SESSION_PLACEHOLDER'Ответы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | application/json | ApiKeyList | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, CREDENTIAL_NOT_ALLOWED |
Машиночитаемый контракт: openapi.json, операция keysList.