Create Publication

POST /publications — Create publications (for external partners)

Коротко: единичный endpoint принимает массив публикаций от внешнего партнёра и создаёт каждую из них в БД. Перед созданием проверяется, что пользователь имеет доступ на автопостинг во всем наборе каналов (атомарно). В теле запроса — подробная валидация (особенно для ALBUM), publish_date нормализуется (timezone убирается). Файловые ресурсы (если указаны file_url) резолвятся в file_id через rekla_bot до сохранения.

Главное про валидацию (обязательно)

1. media_type == ALBUM • Поле album обязательно и не пустое. • Только последний элемент album[“album”][-1] может иметь caption. У всех остальных caption должен быть пустым. • text публикации должен совпадать с caption последнего медиа (text == last_media.caption or "").

2. publish_date • Принимается ISO строкой или datetime. Любая tz-информация удаляется (метод remove_tz): если строка содержит Z, она конвертируется в +00:00, затем tz удаляется — в БД сохраняется naive datetime.

3. text: • Если text отсутствует (null), валидатор конвертирует в пустую строку.

4. report_timeout (внутри DTO, если используется): только 24 или 48.

5. При передаче file_url для не-текстовых медиа: система попытается получить file_id через rekla_bot.get_file_id_by_url. Если это провалится — запрос потерпит ошибку (логирование).

Ответы (HTTP):

1. 201 Created — успешное создание всех публикаций
2. Тело: PublicationCreateResponseList (пример ниже).
3. 403 Forbidden — пользователь не имеет прав автопостинга на один/несколько каналов. Сообщение: “Access denied to one or more channels”.
4. 422 Unprocessable Entity — ошибки валидации входных данных (Pydantic): например, нарушены правила ALBUM, неправильные значения report_timeout и т.д. Тело содержит стандартную структуру ошибок валидации.
5. 400 Bad Request — непредвиденная ошибка на сервере (логируется). Сообщение: “Unexpected error”.

Часто задаваемые вопросы — коротко

1. Что если один из channel_id повторяется в массиве?

• Каналы dedup’ятся при проверке прав (используется set), но в базе создаются записи для каждой публикации — повторные channel_id допустимы.

2. Атомарность: если одна публикация в списке упадёт (например, невалидный ALBUM), весь запрос вернёт ошибку и ничего не закоммитится (исключение до session.commit() → транзакция не сохранит вставки).
3. Кто подставляет external_partner_id?

• Берётся из request.auth.get(“external_partner”) — внешняя система должна передать корректный токен, который ассоциирован с external_partner.

4. Как резолвятся файлы?

• Любой non-TEXT/POLL медиа (IMAGE, VIDEO, etc.) при отсутствии file_id будет резолвлен по file_url через rekla_bot.get_file_id_by_url. Для ALBUM — каждый item резолвится.