Метод для обновления объявления. Обновлять поля объявления можно только когда оно в статусе "NEW".
Запрос
Method | PATCH |
URL | /ads/{{adId}} |
Параметры запроса
Поле | Обязательное | Тип | Описание | Пример |
---|
{{adId}} | Да | String | ID объявления | "A-D7ZL93Z" |
byExternalId | Нет | Boolean | Для поиска сделки по externalId нужно передать true | true |
sellerFirstName | Нет | String | Имя продавца, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз | "Иван" |
sellerLastName | Нет | String | Фамилия продавца, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз | "Иванов" |
sellerPatronymic | Нет | String | Отчество продавца, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз | "Иванович" |
sellerEmail | Нет | String | Электронная почта продавца | "ivanov@mail.test" |
sellerPhone | Нет | String | Номер телефона продавца в формате "380XXXXXXXXX" | "380123456789" |
productTitle | Нет | String | Название товара | "Стол" |
productDescription | Нет | String | Описание товара | "Стол дубовый, б/у" |
productPrice | Нет | Number | Цена товара в копейках, валюта - гривна, только целые числа, больше нуля | 100000 |
productWeight | Нет | Number | Вес товара, в граммах, только целые числа, больше нуля | 15000 |
handlersConfigs | Нет | Array | Массив возможных объектов с данными обработчика для этого объявления |
|
handlersConfigs[].{}.type | Нет | String | Тип обработчика с помощью которого будет производиться доставка товара | "NovaPoshta" |
handlersConfigs[].{}.senderFirstName | Нет | String | Имя отправителя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз | "Иван" |
handlersConfigs[].{}.senderLastName | Нет | String | Фамилия отправителя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз | "Иванов" |
handlersConfigs[].{}.senderPatronymic | Нет | String | Отчество отправителя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз | "Иванович" |
handlersConfigs[].{}.senderPhone | Нет | String | Номер телефона отправителя в формате "380XXXXXXXXX" | "380123456789" |
handlersConfigs[].{}.senderEmail | Нет | String | Электронная почта отправителя | "ivanov@mail.test" |
handlersConfigs[].{}.senderCityId | Нет | String | ID города в системе выбранного обработчика с которого будет осуществлена отправка | "8d5a980d-391c-11dd-90d9-001a92567626" |
handlersConfigs[].{}.senderOfficeId | Нет | String | ID отделения/офиса в системе выбранного обработчика с которого будет осуществлена отправка | "7b2cc7fd-84ff-11e4-acce-0050568002cf" |
paymentsConfigs | Нет | Array | Массив возможных объектов с данными платежа за товар для этого объявления |
|
paymentsConfigs[].{}.type | Нет | String | Тип платежной системы с помощью которой будет производиться оплата товара | "P2P" |
paymentsConfigs[].{}.cardToId | Нет | String | ID карты продавца в выбранной платежной системе, куда будут зачислены деньги после успешной сделки | "058a2fa1-8dee-4c39-8796-574cdc573530" |
Пример:
Code Block |
---|
|
POSTPATCH /ads/A-D7ZL93Z |
Code Block |
---|
|
{
"sellerFirstName": "Иван",
"sellerLastName": "Иванов",
"sellerPatronymic": "Иванович",
"sellerPhone": "380123456789",
"sellerEmail": "ivanov@mail.test",
"productTitle": "Стол",
"productDescription": "Стол дубовый, б/у",
"productPrice": 100000,
"productWeight": 15000,
"handlersConfigs": [
{
"type": "NovaPoshta",
"senderFirstName": "Иван",
"senderLastName": "Иванов",
"senderPatronymic": "Иванович",
"senderPhone": "380987654321",
"senderEmail": "ivanov@mail.test",
"senderCityId": "8d5a980d-391c-11dd-90d9-001a92567626",
"senderOfficeId": "7b2cc7fd-84ff-11e4-acce-0050568002cf"
}
],
"paymentsConfigs": [
{
"type": "P2P",
"cardToId": "058a2fa1-8dee-4c39-8796-574cdc573530"
}
]
} |
Параметры ответа
Поле | Описание |
---|
data | Объект с ответом |
data.id | ID объявления |
data.externalId | Внешний ID объявления |
data.url | URL на сделку в системе Escrow Box |
Пример:
Code Block |
---|
|
{
"data": {
"id": "A-D7ZL93Z",
"externalId": "myExternalId209081",
"url": "https://escrowbox.demo.uapay.ua/ads/A-D7ZL93Z"
}
} |