back to top

Протокол за комуникация

Информацията по-долу е предназначена за порограмисти.
Обявите се подават към alo.bg, като масив, всяка отделна обява е обект от масива.
Файлът трябва да е "json" (mime type application/json) с кодиране "utf-8" without BOM.
Обявите от различните категории имат различна спецификация.
В един файл може да подавате обяви за различни категории, но структурата на всяка една обява трябва да отговаря на спецификацията за конкретната категория.



Формат на json файла за импорт
[
    advert_object1,
    advert_object2,
    advert_object3,
    advert_object4
]
Може да качите файл от Вашият компютър или да посочите неговия URL адрес.
Ако файла отговаря на спецификациите, ще видите интерфейс, показващ в реално време статута на обработка на всяка една обява.
Импортера се стартира като отделен процес на заден план, така че затваряне на страницата не прекъсва процеса.
 
В процеса на импорт към всяка една обява може да бъде генерирано предупреждение (WARNING) или грешка (ERROR).
При WARNING - обявата се добавя/редактира.
При ERROR - обявата не се добавя/редактира (ако вече присъства в сайта остава със старото си състояние).
 
Всички успешно импортирани обяви са със срок на валидност 30 дни.
Винаги подавайте всички Ваши обяви (не само новите). Импортът използва кешове и ако обявите Ви не са променяни, само се удължават с 30 дни, без да се променят.
 
Внимавайте с контактите към обявите. Всички контакти към обявите се добавят, като контактна информация в потребителския Ви профил. Ако се опитате да импортнете обява, съдържаща контакти, присъстващи в друг профил в сайта www.alo.bg, то обявата няма да бъде добавена и ще се генерира съобщение за грешка.
 
Когато импортера приключи може да изтеглите информация за статута на всички импортирани обяви от линк със следната структура:
https://www.alo.bg/import_info_api.php?username=YOUR_USERNAME&api_key=YOUR_API_KEY&last_import=0&error=0&warning=0&ad_json=0&out_ids=all
  • username - потребителско име на акаунта (задължителен параметър)
  • api_key - ключ за достъп до api. Може да го видите след първия успешен импорт. (задължителен параметър)
  • last_import - Само обяви от последния импорт (стойност 0 или 1)
  • error - Само обяви с грешки (стойност 0 или 1)
  • warning - Само обяви с предупреждения (стойност 0 или 1)
  • ad_json - Покажи json на обявата от последния импорт (стойност 0 или 1)
  • out_ids - Само обяви с подадените ID-та (out_id). (стойност all или out_id1,out_id2,out_id3...)
Формат на json файла с информация за импортираните обяви
{
    "error": "(array) Грешки при използване на api",
    "specification_url": "https://www.alo.bg/import_specification.php?menu=home",
    "username": "(string) Потребителско име",
    "count_results": "(integer) Брой резултати в масив results",
    "last_import": {
        "imported": "(integer) Брой успешно импортирани обяви",
        "warnings": "(integer) Брой обяви с предупреждения",
        "errors": "(integer) Брой обяви с грешки",
        "force_archive": "(1/0) Флаг показващ дали е била сложена отметката за архивиране на неприсъстващи обяви",
        "file": "(string) url на подадения файл или празно ако файла е локален",
        "status": "(string) status_string",
        "time_start": "(datetime) Дата и час на стартиране",
        "time_end": "(datetime) Дата и час на приключване",
        "info": "(string) Информация за импорта"
    },
    "results": {
        "out_id1": {
            "ad_id": "(integer или NULL) Номер на обявата в www.alo.bg",
            "ad_url": "(string или NULL) Линк към обявата в www.alo.bg",
            "time_added": "(datetime) Дата и час на първо добавяне в сайта",
            "time_updated": "(datetime) Дата и час последна успешна редакция",
            "time_last_import": "(datetime) Дата и час на последен импорт, в който обявата е присъствала",
            "warning": "(string) Предупреждения (ако има такива)",
            "error": "(string) Грешки (ако има такива)",
            "ttl": "(datetime) Валидност в www.alo.bg",
            "images": "(int) Брой успешно импортирани снимки",
            "ad_status": "(string) ad_status_string",
            "json": "(object при ad_json=1 или NULL) последно подаден JSON"
        },
        "out_id2": {
            "ad_id": "(integer или NULL) Номер на обявата в www.alo.bg",
            "ad_url": "(string или NULL) Линк към обявата в www.alo.bg",
            "time_added": "(datetime) Дата и час на първо добавяне в сайта",
            "time_updated": "(datetime) Дата и час последна успешна редакция",
            "time_last_import": "(datetime) Дата и час на последен импорт, в който обявата е присъствала",
            "warning": "(string) Предупреждения (ако има такива)",
            "error": "(string) Грешки (ако има такива)",
            "ttl": "(datetime) Валидност в www.alo.bg",
            "images": "(int) Брой успешно импортирани снимки",
            "ad_status": "(string) ad_status_string",
            "json": "(object при ad_json=1 или NULL) последно подаден JSON"
        },
        "out_id3": "..."
    }
}
Списък с поддържани категории:
Имоти - Продажби
Имоти - Продажби » Апартаменти
Имоти - Продажби » Къщи, Вили
Имоти - Продажби » Магазини, Офиси, Кабинети, Салони
Имоти - Продажби » Парцели за застрояване, Инвестиционни проекти
Имоти - Продажби » Земеделска земя, градини, лозя, гора
Имоти - Продажби » Складове, промишлени и стопански имоти
Имоти - Продажби » Гаражи, Паркоместа
Имоти - Продажби » Хотели, Мотели
Имоти - Продажби » Заведения
Имоти - Продажби » Заменя имоти
Имоти - Продажби » Купува имоти
Имоти - Продажби » Други имоти
Имоти - Наеми
Имоти - Наеми » Апартаменти под наем
Имоти - Наеми » Къщи под наем
Имоти - Наеми » Стаи под наем, Съквартиранти
Имоти - Наеми » Заведения под наем
Имоти - Наеми » Магазини, Офиси, Кабинети, Салони
Имоти - Наеми » Гаражи, Паркинги, Паркоместа под наем
Имоти - Наеми » Складове, промишлени и стопански имоти под наем
Имоти - Наеми » Парцели, Терени под наем
Имоти - Наеми » Хотели, Почивни станции под наем
Имоти - Наеми » Търси под наем
Авто - Мото
Авто - Мото » Резервни части, консумативи, аксесоари
Авто - Мото » Гуми, Джанти
Туризъм, нощувки
Туризъм, нощувки » Екскурзии, Почивки в чужбина
Туризъм, нощувки » Екскурзии в България
Туризъм, нощувки » Круизи
Електроника
Електроника » Мобилни телефони, GSM
Електроника » Аудио техника
Електроника » Смарт часовници, Фитнес гривни
Електроника » Аксесоари за мобилни устройства
Електроника » Игри и конзоли
Компютри, Офис техника
Компютри, Офис техника » Компютърни компоненти, резервни части
Компютри, Офис техника » Лаптопи
Компютри, Офис техника » Настолни компютри
Компютри, Офис техника » Таблети, E-book четци
Компютри, Офис техника » Монитори
Компютри, Офис техника » Мрежово оборудване
Компютри, Офис техника » Клавиатури, мишки
Този сайт изпозва бисквитки. Вижте повече