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

Техническа документация за програмисти
Бързи факти
Формат
JSON · application/json
Кодиране
UTF-8 без BOM
Структура
масив от обекти — 1 обект = 1 обява
Категории
може да се смесват в един файл; всяка обява следва спецификацията на своята категория
Формат на JSON файла за импорт
Изберете категория от падащото меню, за да заредите точните ѝ полета в първата обява.
[
    { "out_id": "…", "subcat_id": "…", "…": "…" },
    { "out_id": "…", "subcat_id": "…", "…": "…" },
    { "out_id": "…", "subcat_id": "…", "…": "…" },
    { "out_id": "…", "subcat_id": "…", "…": "…" },
]
AI Машинно-четима спецификация (JSON Schema)
Тази JSON Schema представлява спецификация на протокола в машинно четим вид. Подайте я на Вашия AI асистент или разработчик като url. В този JSON са представени всички спецификации на протокола ни като структура, допустими стойности и номенклантура.
https://www.alo.bg/import_json_schema.php
Как работи импортът
Файл може да подадете като url адрес (препоръчително) или файл от компютъра. Импортерът се стартира като отделен процес на заден план, така че затваряне на страницата не го прекъсва. Може да следите в реално време статуса на импортираните обяви както и наличието на грешки и предупреждения.
  • Валидност 30 дни — Всички обяви без грешки присъстващи във файла се удължават с валидност 30 дни.
  • Подавайте всички обяви — alo.bg използва кешове и непроменените обяви само се удължават без да се променят. Ако желаете да деактивирате неактуалните си обяви използвайте опцията "Архивирай предходно импортирани обяви, които не присъстват в този импорт".
  • Предупреждения и грешки — при предупреждение (⚠) обявата се добавя/редактира; при грешка (✖) не се добавя/редактира (ако вече присъства, остава със старото си състояние).
  • Внимание с контактите — всички подадени контакти към обяви се добавят в потребителския Ви профил. Ако контактът вече присъства в друга регистрация, то той бива игнориран с предупреждение (warning).
  • Информация за импортираните обяви — след приключване на процеса по импортиране може да изтеглите машинно четим отчет за състоянието на импортираните Ви обяви в alo.bg. Спецификация на протокола тук.