Create Publication

curl --request POST \
  --url https://api.example.com/external-api/publications \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "external_id": "<string>",
    "channel_id": 123,
    "payment_status": "<string>",
    "text": "<string>",
    "text_len": 123,
    "media_type": "<string>",
    "file_id": "<string>",
    "file_url": "<string>",
    "album": {
      "album": [
        {
          "id": 123,
          "file_id": "<string>",
          "file_url": "<string>",
          "media_type": "<string>",
          "caption": "<string>",
          "caption_len": 123,
          "has_spoiler": true,
          "footers": [
            {
              "id": 123,
              "footer_text": "<string>",
              "text_len": 123,
              "is_selected": true
            }
          ]
        }
      ]
    },
    "poll": {
      "poll": {
        "question": "<string>",
        "options": [
          "<string>"
        ],
        "is_anonymous": true,
        "type": "<string>",
        "allows_multiple_answers": true,
        "correct_option_id": 123,
        "explanation": "<string>",
        "open_period": 123,
        "close_date": "<string>"
      }
    },
    "inline_buttons": {
      "inline_keyboard": [
        [
          {
            "text": "<string>",
            "url": "<string>",
            "callback_data": "<string>",
            "web_url": "<string>",
            "login_url": "<string>",
            "switch_inline_query": "<string>",
            "switch_inline_query_current_chat": "<string>",
            "switch_inline_query_chosen_chat": "<string>",
            "copy_text": "<string>",
            "callback_game": "<string>",
            "pay": "<string>"
          }
        ]
      ]
    },
    "auto_delete": 123,
    "with_sound_notification": true,
    "price": 123,
    "publish_date": "<string>",
    "wp_preview": true,
    "allow_comments": true,
    "has_spoiler": true,
    "protect_content": true,
    "wp_preview_config": {
      "is_disabled": true,
      "url": "<string>",
      "prefer_small_media": true,
      "show_above_text": true
    },
    "comment": "<string>"
  }
]
'

{
  "publications": [
    {
      "id": 123,
      "external_id": "<string>"
    }
  ]
}

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

external-api

publications

Create Publication

curl --request POST \
  --url https://api.example.com/external-api/publications \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "external_id": "<string>",
    "channel_id": 123,
    "payment_status": "<string>",
    "text": "<string>",
    "text_len": 123,
    "media_type": "<string>",
    "file_id": "<string>",
    "file_url": "<string>",
    "album": {
      "album": [
        {
          "id": 123,
          "file_id": "<string>",
          "file_url": "<string>",
          "media_type": "<string>",
          "caption": "<string>",
          "caption_len": 123,
          "has_spoiler": true,
          "footers": [
            {
              "id": 123,
              "footer_text": "<string>",
              "text_len": 123,
              "is_selected": true
            }
          ]
        }
      ]
    },
    "poll": {
      "poll": {
        "question": "<string>",
        "options": [
          "<string>"
        ],
        "is_anonymous": true,
        "type": "<string>",
        "allows_multiple_answers": true,
        "correct_option_id": 123,
        "explanation": "<string>",
        "open_period": 123,
        "close_date": "<string>"
      }
    },
    "inline_buttons": {
      "inline_keyboard": [
        [
          {
            "text": "<string>",
            "url": "<string>",
            "callback_data": "<string>",
            "web_url": "<string>",
            "login_url": "<string>",
            "switch_inline_query": "<string>",
            "switch_inline_query_current_chat": "<string>",
            "switch_inline_query_chosen_chat": "<string>",
            "copy_text": "<string>",
            "callback_game": "<string>",
            "pay": "<string>"
          }
        ]
      ]
    },
    "auto_delete": 123,
    "with_sound_notification": true,
    "price": 123,
    "publish_date": "<string>",
    "wp_preview": true,
    "allow_comments": true,
    "has_spoiler": true,
    "protect_content": true,
    "wp_preview_config": {
      "is_disabled": true,
      "url": "<string>",
      "prefer_small_media": true,
      "show_above_text": true
    },
    "comment": "<string>"
  }
]
'

{
  "publications": [
    {
      "id": 123,
      "external_id": "<string>"
    }
  ]
}

Headers

X-Partner-Id

string

Body

application/json

external_id

string

channel_id

integer

payment_status

string

text

string

text_len

integer

media_type

string

file_id

string

file_url

string

album

object

Show child attributes

album.album

object[]

required

Show child attributes

album.album.id

integer

album.album.file_id

string

album.album.file_url

string

album.album.media_type

string

album.album.caption

string

album.album.caption_len

integer

album.album.has_spoiler

boolean

album.album.footers

object[]

Show child attributes

album.album.footers.id

integer

album.album.footers.footer_text

string

album.album.footers.text_len

integer

album.album.footers.is_selected

boolean

poll

object

Show child attributes

poll.poll

object

required

Show child attributes

poll.poll.question

string

required

poll.poll.options

string[]

required

poll.poll.is_anonymous

boolean

required

poll.poll.type

string

required

poll.poll.allows_multiple_answers

boolean

required

poll.poll.correct_option_id

integer

required

poll.poll.explanation

string

required

poll.poll.open_period

integer

required

poll.poll.close_date

string

required

inline_buttons

object

Show child attributes

inline_buttons.inline_keyboard

object[][]

required

Show child attributes

inline_buttons.inline_keyboard.text

string

inline_buttons.inline_keyboard.url

string

inline_buttons.inline_keyboard.callback_data

string

inline_buttons.inline_keyboard.web_url

string

inline_buttons.inline_keyboard.switch_inline_query

string

inline_buttons.inline_keyboard.switch_inline_query_current_chat

string

inline_buttons.inline_keyboard.switch_inline_query_chosen_chat

string

inline_buttons.inline_keyboard.copy_text

string

inline_buttons.inline_keyboard.callback_game

string

inline_buttons.inline_keyboard.pay

string

auto_delete

integer

with_sound_notification

boolean

price

integer

publish_date

string

wp_preview

boolean

allow_comments

boolean

has_spoiler

boolean

protect_content

boolean

wp_preview_config

object

Show child attributes

wp_preview_config.is_disabled

boolean

required

wp_preview_config.url

string

required

wp_preview_config.prefer_small_media

boolean

required

wp_preview_config.show_above_text

boolean

required

comment

string

Response

201 - application/json

publications

object[]

required

Show child attributes

publications.id

integer

required

publications.external_id

string

required

Check posting permission in a channel Cancel Publication

⌘I

Начало работы

Автопостинг

Вспомогательные функции

Лучшие практики

Справочная информация

Туториалы

API

Create Publication

POST /publications — Create publications (for external partners)

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

Ответы (HTTP):

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

Headers

Body

Response