REST API
DELETE/ api/ v1/ keys/ { id}
Отозвать собственный API-ключ.
| Поле | Значение |
|---|---|
| URL | DELETE |
| Доступ | Cookie кабинета |
| Scope для ключей | ключи не принимаются – только кабинет (403 CREDENTIAL_) |
| Свежий вход | не старше 10 минут |
| operationId | keysRevoke |
Описание#
Отозвать собственный API-ключ. Повторный отзыв, неизвестный или чужой id – NOT_.
Auth: сессия кабинета (cookie). Fresh auth ≤10 минут. Scope: не требуется.
Path (обязателен каждый параметр):
| Поле | Тип | Обязательно | Ограничения |
|---|---|---|---|
id | string | да | формат "uuid"; pattern см. полную схему |
Query: нет объявленных полей.
Body: не требуется.
Ответ · статус и структура
Ответ: 204, без тела.
Ошибки: 401 , 403 , 503 , 429 , 403 , 422 , 403 , 401 , 404 ; общие ошибки.
Лимиты: Отдельного throttle в коде нет.
curl -sS -i -X DELETE https://aos.edgelab.space/api/v1/keys/00000000-0000-4000-8000-000000000001 \
--cookie '__Host-aos_sess=SESSION_PLACEHOLDER' \
-H 'Origin: https://aos.edgelab.space'Ответы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 204 | – | – | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, ORIGIN_REJECTED, VALIDATION_FAILED, CREDENTIAL_NOT_ALLOWED, REAUTH_REQUIRED, NOT_FOUND |
Машиночитаемый контракт: openapi.json, операция keysRevoke.