Poputchiki API — описание

Публичные (без токена): GET /v1/public/* — только опубликованные объявления.

Приватные (Bearer токен): создание заявок, модерация, очередь публикаций.

Публичные эндпоинты

• GET /v1/public/submissions — список опубликованных
• GET /v1/public/submissions/{id} — деталка
• GET /v1/public/filters — справочники (города/страны/опции)

Приватные эндпоинты

• POST /v1/submissions — создать заявку (status=pending)
• POST /v1/submissions/{id}/approve — одобрить и назначить publish_at
• POST /v1/submissions/{id}/reject — отклонить
• GET /v1/submissions — список (для админки)

Статусы

draft → pending → (approved/scheduled) → published
               ↘ rejected

Пример создания заявки

POST /v1/submissions
Authorization: Bearer <TOKEN>

{
  "type": "travel",
  "channel_key": "main",
  "fields": {
    "you": "Жен",
    "companion": "Муж",
    "to_country": "ОАЭ",
    "to_city": "Любой",
    "from_city": "Москва",
    "when": "Март"
  },
  "comment": "Хочу пляж и экскурсии",
  "contact": "@username",
  "media": [{"kind":"photo","tg_file_id":"..."}]
}

Очередь публикаций (1 раз в час + окно 09:00–23:00 МСК) рассчитывается на /approve.