За допомогою даного API ви можете додати оголошення на AGRO.RIA
Метод запиту: POST
Приклад запиту
curl -X POST 'https://developers.ria.com/agro_ria/create_advertisement?api_key=API_KEY'
Обов'язкові параметри запиту:
| Параметр | Тип | Опис |
|---|---|---|
| api_key | ваш API ключ | |
| photos | Array string | масив урлів по яких доступні фото |
| tag_id | Number | id Борони чи Трактора із АРІ тегів |
| marka_id | Number | id марки із АРІ Марки |
| model_id | Number | id моделі із АРІ Моделі |
| year | Number | рік випуску техніки від 1900 до поточного |
| price | Number | ціна в USD |
| user_id | Number | id вашого юзера |
| state_id | Number | id області state_id АРІ Області |
| city_id | Number | id (city_id) обласного або районного центра, API Населені пункти |
| settlement_id | Number | id населеного пункта API Населені пункти |
| phones | Array string | масив із телефонів формату 0631234567 |
| free_shipping | Number | безкоштовна доставка: 0 - не доступна; 1 - доступна ; також можна використовувати true/false |
| vat | Number | З ПДВ: 0 - не включено ціну; 1 - включено в ціну; також можна використовувати true/false |
| leasing | Number | послуга лізингу: 0 - не доступна; 1 - доступна; також можна використовувати true/false |
| payment_in_installments | Number | рострочка: 0 - не доступна; 1 - доступна; також можна використовувати true/false |
| description | String | опис оголошення |
| vin | String | VIN-код (має містити 17 символів) |
Приклад відповіді
HTTPstatus: 200,
body: {ok: {adv_id: adv_id(id нового оголошення), phones: "06" - номери телефонів на які додались оголошення}}
{.is-success}
Приклад помилкової відповіді
помилка сервера HTTPstatus: 500, body: {error: "Error text"}
помилка валідації HTTPstatus: 400, body: {validation_error: {помилки валідації вхідних даних}}