POST - Загрузка фото пользователя
Описание
Метод POST /users/{id}/photo используется для загрузки фото для пользователя по его уникальному идентификатору (ID). Запрос должен содержать файл фото, который будет связан с профилем пользователя.
Аутентификация
| Заголовок | Описание | Пример |
|---|---|---|
| Authorization | Токен для аутентификации. | Authorization: Bearer abcdef1234567890 |
Структура запроса
Параметры пути
| Параметр | Тип | Описание | Обязательный |
|---|---|---|---|
| id | UUID | Уникальный идентификатор пользователя. | Да |
Тело запроса
Тело запроса должно содержать файл фото в формате form-data.
| Поле | Тип | Описание | Обязательное |
|---|---|---|---|
| photo | Файл | Файл с фото для загрузки. | Да |
Пример запроса
URL запроса
POST /users/be63c536-6cf3-4866-8970-37a956e3f403/photo
Authorization: Bearer abcdef1234567890
Тело запроса
| Ключ | Значение |
|---|---|
| photo | (Выберите файл для загрузки) |
Возможные ответы
1. Некорректные данные ввода
HTTP Статус Код: 400 Bad Request
Тело ответа:
{
"message": "invalid input data",
"code": "input.data.invalid",
"timestamp": "2023-03-07T05:57:59.315Z"
}
Описание: Загруженные данные некорректны (например, неверный формат файла или отсутствуют обязательные параметры).
2. Ресурс не найден
HTTP Статус Код: 404 Not Found
Тело ответа:
{
"message": "resource wasn't found",
"code": "not.found",
"timestamp": "2023-03-07T05:57:59.315Z"
}
Описание: Пользователь с указанным ID не найден.
3. Внутренняя ошибка сервера
HTTP Статус Код: 500 Internal Server Error
Тело ответа:
{
"message": "internal server error",
"code": "internal.server.error",
"timestamp": "2023-03-07T05:57:59.315Z"
}
Описание: Произошла ошибка на сервере при обработке запроса.
Резюме
Метод POST /users/id/photo позволяет загрузить фото в профиль пользователя. Успешное выполнение запроса приведет к загрузке фото и его ассоциации с аккаунтом пользователя. Ошибки, такие как некорректные данные ввода, несуществующие пользователи или проблемы на сервере, обрабатываются с соответствующими ответами.