Перейти к содержимому

⚙️ API доски DailyDigs

Открытый REST API: выкладывайте объявления, читайте и отвечайте в чатах, продвигайте — из своих программ, ботов и сервисов. Обмен — JSON поверх HTTPS. Чтение открыто всем, запись — по ключу.

🔑 Ваш ключ
Войдите на сайт, чтобы получить персональный ключ.

Авторизация

Передавайте ключ в заголовке X-Api-Key: КЛЮЧ (или Authorization: Bearer КЛЮЧ).

Объявления

GET https://doska.dailydigs.ru/api/v1/listings — поиск: q, category_id, city_id, price_min, price_max, sort, page
GET https://doska.dailydigs.ru/api/v1/listings/{id} — одно объявление с фото
POST https://doska.dailydigs.ru/api/v1/listings — создать (контакты подставятся из вашего профиля)
PUT https://doska.dailydigs.ru/api/v1/listings/{id} — изменить
DELETE https://doska.dailydigs.ru/api/v1/listings/{id} — удалить
POST …/listings/{id}/freeboost — бесплатный подъём (раз в 7 дней)
POST …/listings/{id}/promote — продвижение: {"plan":"x2|x5|x10|color|vip","days":7}
curl -X POST 'https://doska.dailydigs.ru/api/v1/listings' \
  -H 'X-Api-Key: ВАШ_КЛЮЧ' -H 'Content-Type: application/json' \
  -d '{"title":"Сдам 2-к квартиру у парка","description":"Светлая, вся техника, метро рядом",
       "category_id":15,"price":2500,"city_id":1,
       "photos":["https://example.com/foto1.jpg"]}'

Чаты

GET https://doska.dailydigs.ru/api/v1/chats — мои диалоги (id, объявление, непрочитанные)
GET …/chats/{id}/messages?after=N — сообщения новее N (для поллинга)
POST …/chats/{id}/messages — отправить {"text":"Здравствуйте!"}
> curl -H 'X-Api-Key: ВАШ_КЛЮЧ' 'https://doska.dailydigs.ru/api/v1/chats'
{"ok":true,"chats":[{"id":1,"item_id":28,"item_title":"1-к квартира…","unread":2,…}]}

> curl -X POST 'https://doska.dailydigs.ru/api/v1/chats/1/messages' \
    -H 'X-Api-Key: ВАШ_КЛЮЧ' -H 'Content-Type: application/json' \
    -d '{"text":"Добрый день! Квартира свободна на выходные."}'
{"ok":true}

Справочники

GET https://doska.dailydigs.ru/api/v1/categories — дерево категорий с id
GET https://doska.dailydigs.ru/api/v1/locations — регионы и города с id
GET https://doska.dailydigs.ru/api/v1/ping — жив ли API

Ответы и ошибки

Успех — {"ok":true,…}. Ошибка — {"error":"описание"} с кодом: 401 нет ключа · 403 чужое/нет прав · 404 не найдено · 422 движок не принял данные · 429 слишком часто.