Метод для обновления объявления. Обновлять поля объявления можно только когда оно в статусе "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" |
Пример:
PATCH /ads/A-D7ZL93Z
{ "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 |
Пример:
{ "data": { "id": "A-D7ZL93Z", "externalId": "myExternalId209081", "url": "https://escrowbox.demo.uapay.ua/ads/A-D7ZL93Z" } }