REST API
DELETE/ api/ v1/ files/ { id}
Удалить только собственную ещё не прикреплённую загрузку.
| Поле | Значение |
|---|---|
| URL | DELETE |
| Доступ | Cookie кабинета · Mini App (TMA) |
| Scope для ключей | ключи не принимаются – только кабинет (403 CREDENTIAL_) |
| operationId | filesDelete |
Описание#
Удалить только собственную ещё не прикреплённую загрузку. Уже использованное в сообщении вложение удалить этим методом нельзя (404). Неиспользованные файлы автоматически очищаются через час.
Auth: сессия кабинета (cookie) / TMA bearer. Scope: не требуется.
Path (обязателен каждый параметр):
| Поле | Тип | Обязательно | Ограничения |
|---|---|---|---|
id | string | да | формат "uuid"; pattern см. полную схему |
Query: нет объявленных полей.
Body: не требуется.
Ответ · статус и структура
Ответ: 204, без тела.
Ошибки: 401 , 403 , 503 , 429 , 403 , 422 , 404 , 403 ; общие ошибки.
Лимиты: Отдельного throttle в коде нет.
curl -sS -i -X DELETE https://aos.edgelab.space/api/v1/files/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, NOT_FOUND |
Машиночитаемый контракт: openapi.json, операция filesDelete.