Headers
Body
application/json · object[]
Response
201 - application/json
API Reference
Create Publication
POST /publications — Create publications (for external partners)
Коротко: единичный endpoint принимает массив публикаций от внешнего партнёра и создаёт каждую из них в БД. Перед созданием проверяется, что пользователь имеет доступ на автопостинг во всем наборе каналов (атомарно). В теле запроса — подробная валидация (особенно для ALBUM), publish_date нормализуется (timezone убирается). Файловые ресурсы (если указаны file_url) резолвятся в file_id через rekla_bot до сохранения.
Главное про валидацию (обязательно)
-
media_type == ALBUM • Поле album обязательно и не пустое. • Только последний элемент album[“album”][-1] может иметь caption. У всех остальных caption должен быть пустым. • text публикации должен совпадать с caption последнего медиа (text == last_media.caption or "").
-
publish_date • Принимается ISO строкой или datetime. Любая tz-информация удаляется (метод remove_tz): если строка содержит Z, она конвертируется в +00:00, затем tz удаляется — в БД сохраняется naive datetime.
-
text: • Если text отсутствует (null), валидатор конвертирует в пустую строку.
-
report_timeout (внутри DTO, если используется): только 24 или 48.
-
При передаче file_url для не-текстовых медиа: система попытается получить file_id через rekla_bot.get_file_id_by_url. Если это провалится — запрос потерпит ошибку (логирование).
Ответы (HTTP):
- 201 Created — успешное создание всех публикаций
- Тело: PublicationCreateResponseList (пример ниже).
- 403 Forbidden — пользователь не имеет прав автопостинга на один/несколько каналов. Сообщение: “Access denied to one or more channels”.
- 422 Unprocessable Entity — ошибки валидации входных данных (Pydantic): например, нарушены правила ALBUM, неправильные значения report_timeout и т.д. Тело содержит стандартную структуру ошибок валидации.
- 400 Bad Request — непредвиденная ошибка на сервере (логируется). Сообщение: “Unexpected error”.
Часто задаваемые вопросы — коротко
- Что если один из channel_id повторяется в массиве?
- Каналы dedup’ятся при проверке прав (используется set), но в базе создаются записи для каждой публикации — повторные channel_id допустимы.
- Атомарность: если одна публикация в списке упадёт (например, невалидный ALBUM), весь запрос вернёт ошибку и ничего не закоммитится (исключение до session.commit() → транзакция не сохранит вставки).
- Кто подставляет external_partner_id?
- Берётся из request.auth.get(“external_partner”) — внешняя система должна передать корректный токен, который ассоциирован с external_partner.
- Как резолвятся файлы?
- Любой non-TEXT/POLL медиа (IMAGE, VIDEO, etc.) при отсутствии file_id будет резолвлен по file_url через rekla_bot.get_file_id_by_url. Для ALBUM — каждый item резолвится.
POST
⌘I