REST API
GET/ api/ v1/ me/ avatar
Собственный аватар, JPEG/WebP.
| Поле | Значение |
|---|---|
| URL | GET |
| Доступ | Cookie кабинета · Mini App (TMA) |
| Scope для ключей | ключи не принимаются – только кабинет (403 CREDENTIAL_) |
| operationId | meAvatar |
Описание#
Собственный аватар, JPEG/WebP. v – cache-buster; ETag + If- дают 304. Успешные ответы используют Cache-; отсутствие фото – 404.
Auth: сессия кабинета (cookie) / TMA bearer. Scope: не требуется.
Path: параметров нет.
Query:
| Поле | Тип | Обязательно | Ограничения |
|---|---|---|---|
v | string | нет | pattern см. полную схему |
Body: не требуется.
Ответ · статус и структура
Ответ: 200; бинарное тело image/, image/. 304 без тела при совпадении If-.
Ошибки: 401 , 403 , 503 , 429 , 404 , 403 ; общие ошибки.
Лимиты: Отдельного throttle в коде нет.
curl -sS -i https://aos.edgelab.space/api/v1/me/avatar \
--cookie '__Host-aos_sess=SESSION_PLACEHOLDER'Ответы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | image/jpeg | – | Успех |
| 304 | – | – | Not Modified (If-None-Match matched the ETag) |
| ошибка | application/json | ErrorBody | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, NOT_FOUND |
Машиночитаемый контракт: openapi.json, операция meAvatar.