Перейти к основному содержимому

Загрузка медиа

Swagger - подробное API медиа.

Интерфейс тела запроса на загрузку медиа:

Формат: multipart/form-data

{
"publicKey": "string",
"hash": "string",
"file": "binary"
}

Таблица с описанием всех полей тела запроса:

ПолеТипОбязательныйОписание
publicKeyStringДаПубличный ключ, который выдавался при регистрации мерчанта на платформе FirstPay (Ключ передается в файле, нужно передать все его содержимое).
hashStringДаЗакодированная строка тела запроса. О том как ее сформировать - см. в разделе "Авторизация".
fileBinaryДаБинарник медиа

Таблица возвращаемых ответов:

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"
}

Таблица с описанием всех полей:

ПолеТипОписание
idStringID медиа.
nameStringНазвание файла.
sizeNumberРазмер файла.
createdAtStringДата создания.