REST API для отправки постов в Telegram, VK и Max из своего бэкенда

Crosslybot предоставляет простой REST API для разработчиков: вместо подключения к трём разным API (Telegram Bot API, VK API, Max API) — один webhook URL и один Bearer-токен. Один JSON-запрос — пост публикуется во всех настроенных платформах.

API спроектирован под developer experience: входящий формат принимает Telegram entities (offset/length/type) — переиспользуй TG-код с минимальными правками. Исходящий формат отдаёт text + text_html — выбирай удобный для целевой платформы. Стандартные HTTP-коды, Idempotency-Key как у Stripe, префиксы токенов как у GitHub.

Минимальный пример (cURL)

curl -X POST https://wh.crosslybot.ru/v1/webhooks/{endpoint_id} \
  -H "Authorization: Bearer crossly_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 8f4a-1234-..." \
  -d '{
    "text": "Привет из API!",
    "entities": [
      {"type": "bold", "offset": 0, "length": 6}
    ],
    "media": [
      {"type": "photo", "url": "https://cdn.example.com/img.jpg"}
    ]
  }'

В ответ — 200 OK + ID созданного поста. Crosslybot обрабатывает payload, прогоняет через AI/фильтры/подпись и публикует во все цели проекта.

Что в payload

*минимум одно из text/media/buttons.

Ответ API

{
  "ok": true,
  "id": "post_abc123",
  "trace_id": "tr_..." ,
  "queued_targets": 3
}

При ошибке валидации (4xx) — список конкретных проблем:

{
  "ok": false,
  "errors": [
    "media[0]: тип 'document' не поддерживается",
    "entity[2]: offset+length выходит за длину текста"
  ]
}

Что отличает Crosslybot REST API

• Унификация трёх платформ: TG, VK, Max через один payload
• Bearer-токен — простая интеграция с LLM-агентами и no-code инструментами
• Idempotency-Key — безопасные ретраи, как у Stripe
• Принимаем Telegram entities (IN) — большинство существующего кода для TG переиспользуется. Исходящий webhook отдаёт text + text_html для удобства любой платформы-приёмника.
• AI-обработка из коробки: переводы, фильтры, замены, подпись

С чего начать

1. Зарегистрируйтесь в Crosslybot (Pro+ тариф для webhook input)
2. Создайте webhook endpoint, скопируйте Bearer-токен
3. Привяжите к проекту с целями TG/VK/Max
4. Тестируйте через sandbox: POST /v1/sandbox/test
5. Интегрируйте в свой код

Webhook input доступен на тарифах Pro, Maxi и Business.