Доска бесплатных объявлений
Помощь   Личный кабинет
Добавить объявление без регистрации



Главная / Документация API

Документация к API

С помощью API, Вы можете создавать приложения для публикации объявлений на нашем сайте.

Текущая версия - 1.0. Для доступа к api скопируйте ключ из личного кабинета. Ключ доступа выдается всем зарегистрированным пользователям автоматически.

Добавление объявления на сайт

Метод "add"

Создает объявление. Принимает запросы в формате JSON

Структура запроса:

{
    "method":"add", /* required */
    "params":{
        "country":0, /* required */
        "city":0, /* required */
        "section":"auto", /* required */
        "category":24, /* required */
        "days":365, /* required */
        "type":1, /* required */
        "contact":"Светлана", /* required */
        "telephone":"123-13-13", /* required */
        "title":"Audi", /* required */
        "description":"машина", /* required */
        "url":"https://oyoo.ru/", /* optional */
        "pricetype":1, /* required */
        "price":780000.50, /* required */
        "currency":35, /* required */
        "images":[ /* optional */
            {
                "imageData":"iVB...", /* required */
                "originalName":"car.png" /* required */
            }
        ]
    },
    "autoOptions":{ /* optional for "auto" */
        "brand":10, /* optional */
        "model":20, /* optional */
        "year":2017, /* optional */
        "mileage":3000.78, /* optional */
        "body":1, /* optional */
        "customs":1, /* optional */
        "state":1, /* optional */
        "color":15, /* optional */
        "motor":2, /* optional */
        "rudder":2, /* optional */
        "transmission":1 /* optional */
    }
}        
        

Параметр Тип Описание Обязательный
Структура JSON
method string значение "add" - создание объявления да
Структура params
Обязательные поля
country integer Номер страны. Список значений да
city integer Номер города. Доступные города для стран: список значений да
section string Главный раздел объявлений. список значений да
category integer Номер категории. список значений да
days integer Срок публикации объявления. От 7 до 365 дней да
type Тип Тип объявления. cписок значений да
contact string Контактное лицо да
telephone string Телефон. В любом понятном для посетителя формате да
title string Название товара/услуги. Не более 100 символов да
description string Текст объявления да
url string Адрес сайта с дополнительной информацией о товаре/услуге. Полный адрес c http:// или https:// нет
pricetype integer Тип стоимости cписок значений да
currency integer В какой валюте указана цена cписок значений да
price number Цена - целое или дробное значение да
Структура images
Добавление изображений к объявлению. Не обязательное поле. На размер картинок по высоте и ширине ограничений нет
imageData string Изображение, закодированное в base64 да, при наличии изображения
originalName string Имя оригинального файла. Расширение должно быть jpg, jpeg, png или gif да, при наличии изображения
Структура autoOptions
Дополнительные поля для раздела "Легковые автомобили" (категория №24)
brand integer Номер брэнда на сайте список значений нет
model integer Номер модели на сайте список значений нет
year integer Год выпуска. От 1885 до 2018 нет
mileage number Пробег нет
body integer Номер типа кузова на сайте список значений нет
customs integer Таможня список значений нет
state integer Состояние список значений нет
color integer Цвет кузова список значений нет
motor integer Тип двигателя список значений нет
rudder integer Руль список значений нет
transmission integer Коробка передач список значений нет

Примеры на PHP

Добавление объявления с фото в раздел "Недвижимость"


Добавление объявления в раздел "Транспорт"


Добавление объявления в раздел "Товары"