Загрузка медиа
Swagger - подробное API медиа.
Интерфейс тела запроса на загрузку медиа:
Формат: multipart/form-data
{
"publicKey": "string",
"hash": "string",
"file": "binary"
}
Таблица с описанием всех полей тела запроса:
| Поле | Тип | Обязательный | Описание | |||||
|---|---|---|---|---|---|---|---|---|
| publicKey | String | Да | Публичный ключ, который выдавался при регистрации мерчанта на платформе FirstPay (Ключ передается в файле, нужно передать все его содержимое). | |||||
| hash | String | Да | Закодированная строка тела запроса. О том как ее сформировать - см. в разделе "Авторизация". | |||||
| file | Binary | Да | Бинарник медиа | |||||
Таблица возвращаемых ответов:
| code | Тело ответа | Описание |
|---|---|---|
| 200 | Медиа | При успешном запросе возвращаются данные по загруженному медиа. |
| 400 | {"error": "some text here..."} | Ошибка возникает, если не удалось распарсить тело запроса и query параметры. (скорее всего они были переданы с ошибкой). |
| 401 | {"error": "NO_LOGIN"} | Ошибка возникает, если не передали в теле запроса поле publicKey. |
| 401 | {"error": "NO_TOKEN"} | Ошибка возникает, если не передали в теле запроса поле hash. |
| 401 | {"error": "NO_KEY"} | Ошибка возникает, если передан неправильный publicKey. |
| 401 | {"error": "UNAUTHORIZED"} | Ошибка возникает, если произошла ошибка при валидации publicKey и hash. |
| 500 | {"error": "some text here..."} | Ошибка возникает, когда сервер не смог обработать запрос и произошла какая-то не штатная ситуация. |
Описание полей медиа
Интерфейс загруженного медиа:
{
"id": "string",
"name": "string",
"size": "number",
"createdAt": "string"
}
Таблица с описанием всех полей:
| Поле | Тип | Описание | |||||
|---|---|---|---|---|---|---|---|
| id | String | ID медиа. | |||||
| name | String | Название файла. | |||||
| size | Number | Размер файла. | |||||
| createdAt | String | Дата создания. | |||||