Объявления и каталог
Чтение каталога, собственные объявления и состояние публикации
Чтение
GET /api/v1/listings возвращает доступный пользователю каталог. Используйте параметры операции для пагинации и фильтрации; поля зависят от вертикали.
GET /api/v1/listings/{id} читает отдельное объявление. Видимость, модерация и права влияют на ответ: не считайте любую ссылку публичной.
Собственные объявления
| Операция | Назначение |
|---|---|
GET /api/v1/listings/my | Собственные объявления |
GET /api/v1/listings/my/status-counts | Количество по статусам |
POST /api/v1/listings/{id}/pause | Приостановить объявление |
POST /api/v1/listings/{id}/resume | Возобновить объявление |
POST /api/v1/listings/my/pause-all | Массовая приостановка |
POST /api/v1/listings/my/resume-all | Массовое возобновление |
Условия операций зависят от вида объявления и вертикали; например, возобновление может проверять тариф и лимит публикаций. Массовые операции меняют несколько объектов. Изучите их ограничения в API Reference и своей версии CMS, затем проверьте результат чтением.
Создание и изменение
Используйте схемы операций из справочника. Подготовьте категорию, тип сущности и обязательные поля вертикали. Сохранение не равно публикации: объявление может ожидать модерации или других условий размещения.
Не переносите автоматически payload товара в услугу или проект фриланса. Проверяйте владельца, тарифные ограничения и состояния на тестовой записи.
Импорт
Встроенный импорт и импорт через внешний модуль — отдельные механизмы. Используйте инструкции базы знаний, сопоставление полей и небольшую тестовую выборку. До массовой загрузки настройте дедупликацию и резервное копирование.