REST API
POST/ api/ v1/ files
Загрузить вложение raw bytes, не multipart: тип сверяется с сигнатурой/UTF-8.
| Поле | Значение |
|---|---|
| URL | POST |
| Доступ | Cookie кабинета · Mini App (TMA) |
| Scope для ключей | ключи не принимаются – только кабинет (403 CREDENTIAL_) |
| operationId | filesUpload |
Описание#
Загрузить вложение raw bytes, не multipart: тип сверяется с сигнатурой/UTF-8. До 10 MiB на файл; публичный домен ограничивает тело 4 MB ещё до API. Изображения до 3.75 MiB, сторона ≤4096 px, ≤7 450 000 пикселей; PDF до 20 страниц; извлечённый текст до 20 000 символов (длинный обрезается с textTruncated=). Параллельные загрузки разрешены; сохранённый id передаётся в TutorSendRequest..
Auth: сессия кабинета (cookie) / TMA bearer. Scope: не требуется.
Path: параметров нет.
Query:
| Поле | Тип | Обязательно | Ограничения |
|---|---|---|---|
name | string | нет | длина ≥ 1; длина ≤ 200 |
Body: обязательные raw bytes; Content-: image/, image/, image/, application/, text/, text/.
Ответ · статус и структура
Ответ: 200 application/, Upload.
Краткая форма: {.
Пример JSON; значения демонстрационные.
{
"id": "7a1c2e3f-4b5d-4e6f-8a9b-0c1d2e3f4a51",
"name": "скрин ошибки.png",
"mime": "image/png",
"kind": "image",
"size": 184320,
"width": 1179,
"height": 2556,
"pages": null,
"textTruncated": false,
"createdAt": "2026-11-06T08:59:30.000Z"
}Ошибки: 401 , 403 , 503 , 429 , 403 , 422 , 429 , 409 , 403 ; общие ошибки.
Лимиты: параллельные загрузки разрешены. Для PDF – до 2 резерваций на студента суммарно в обработке и ожидании. 20 попыток/день МСК, сброс в 00:00 МСК; отказы после резервирования дневной попытки тоже считаются, кроме отказа из-за занятости сервера: такая попытка возвращается в квоту. Превышение собственных 2 PDF-резерваций попытку расходует. Оба вида занятости дают 429 , сообщение «Сервер занят, попробуйте через минуту», retryAfterSec:; исчерпанная дневная квота – 429 . Лимит хранения – 200 MiB: все неприкреплённые и прикреплённые за последние 30 суток.
curl -sS -i -X POST 'https://aos.edgelab.space/api/v1/files?name=example.txt' \
--cookie '__Host-aos_sess=SESSION_PLACEHOLDER' \
-H 'Origin: https://aos.edgelab.space' \
-H 'Content-Type: text/plain' \
--data-binary @example.txtОтветы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | application/json | Upload | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, ORIGIN_REJECTED, VALIDATION_FAILED, DAILY_LIMIT, STORAGE_LIMIT, RATE_LIMITED |
Машиночитаемый контракт: openapi.json, операция filesUpload.