# GET /api/v1/keys

История персональных API-ключей: active первыми, затем новые.

| Поле | Значение |
| --- | --- |
| URL | `GET https://aos.edgelab.space/api/v1/keys` |
| Доступ | Cookie кабинета |
| Scope для ключей | ключи не принимаются – только кабинет (403 `CREDENTIAL_NOT_ALLOWED`) |
| operationId | `keysList` |

## Описание

История персональных API-ключей: active первыми, затем новые; не более 50, только prefix, scopes и метаданные, без secret. OAuth keys исключены из списка.

**Auth:** сессия кабинета (cookie). **Scope:** не требуется.

**Path:** параметров нет.

**Query:** нет объявленных полей.

**Body:** не требуется.

**Ответ · статус и структура**

**Ответ:** 200 `application/json`, [ApiKeyList](/docs/schemas#apikeylist).

Краткая форма: `{ keys: (ApiKey)[] }`.

Пример JSON; значения демонстрационные.

```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 UNAUTHENTICATED`, `403 NO_ENTITLEMENT`, `503 ENTITLEMENT_UNAVAILABLE`, `429 RATE_LIMITED`, `403 CREDENTIAL_NOT_ALLOWED`; [общие ошибки](/docs/errors).

**Лимиты:** Отдельного throttle в коде нет.

```bash
curl -sS -i https://aos.edgelab.space/api/v1/keys \
  --cookie '__Host-aos_sess=SESSION_PLACEHOLDER'
```

## Ответы по контракту

| Статус | Тип | Схема | Описание |
| --- | --- | --- | --- |
| 200 | application/json | [ApiKeyList](/docs/schemas#apikeylist) | Успех |
| ошибка | application/json | [ErrorBody](/docs/schemas#errorbody) | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, CREDENTIAL_NOT_ALLOWED |

Машиночитаемый контракт: [openapi.json](/docs/openapi.json), операция `keysList`.
