HTTP API

Первый запрос

Установка

HTTP API

No installation needed — just call the HTTP API directly.

POST https://sidekick-ads.com/api/v1/ad
Authorization: Bearer sk_live_xxxxx
Content-Type: application/json

Быстрый старт

Отправьте JSON-запрос с API-ключом и ID площадки. Ниже показаны ответы с рекламой и без неё.

curl

curl -X POST https://sidekick-ads.com/api/v1/ad \
  -H "Authorization: Bearer sk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": 123456789,
    "message": "Python — это высокоуровневый язык программирования...",
    "platform_id": "plt_a1b2c3d4e5f6",
    "language_code": "ru",
    "is_premium": false,
    "parse_mode": "HTML"
  }'

# Response (ad served):
{
  "message": "Python — это высокоуровневый язык программирования...\n\n<a href=\"https://t.me/heysidekick\">Реклама от Sidekick 👇</a>\n\n<a href=\"https://sidekick-ads.com/api/v1/click/imp_a8f3d2c1e9b7\">💡 Try Cursor — AI editor for developers</a>",
  "has_ad": true,
  "impression_id": "imp_a8f3d2c1e9b7",
  "ad": {
    "text": "💡 Try Cursor — AI editor for developers",
    "formatted_text": "💡 Try <b>Cursor</b> — <a href=\"https://sidekick-ads.com/api/v1/click/imp_a8f3d2c1e9b7\">AI editor for developers</a>",
    "button_text": "Try it →",
    "button_url": "https://sidekick-ads.com/api/v1/click/imp_a8f3d2c1e9b7"
  }
}

# Response (no ad):
{
  "message": "Python — это высокоуровневый язык программирования...",
  "has_ad": false,
  "impression_id": null,
  "ad": null
}