Постбэк и API: подключение трекера и сайта

Кому это нужно

• Арбитражникам — чтобы видеть расходы и результат в одном месте в трекере вроде Keitaro, Binom или Voluum.
• Партнёрам со своим лендингом — чтобы отправлять заказы из формы на своём сайте напрямую в платформу.
• Разработчикам — чтобы получать офферы и статусы заказов в свой бот, CRM или таблицу.
• Тем, кто работает с AI-ассистентом — чтобы дать Claude или ChatGPT задачу «найди самый продаваемый товар и создай ссылку».

Шаг 1: создайте API-ключ

1. Откройте в кабинете раздел «API и интеграции».
2. Нажмите «Создать ключ», задайте название (например, «Keitaro») и отметьте только нужные разрешения.
3. При желании привяжите ключ к IP вашего сервера и выберите срок действия.
4. Ключ показывается один раз — скопируйте его и храните на сервере. Никому не передавайте и не вставляйте в код сайта.

При создании ключа вам приходит уведомление в Telegram и в кабинете. Если ключ создали не вы — сразу отзовите его.

Шаг 2: подключите постбэк в трекер

Постбэк — это запрос, который платформа сама отправляет в ваш трекер при смене статуса заказа. Для подключения нужны две вещи:

1. Добавьте click_id в ссылку. Добавьте к ссылке потока макрос click ID вашего трекера: https://birinchishop.uz/l/123?click_id={subid} (в Keitaro обычно {subid}, в Binom — {clickid}). Для дополнительных меток есть sub1–sub5.
2. Добавьте адрес постбэка. В кабинете: «Вебхуки и постбэки» → «Добавить» → Постбэк. Вставьте URL постбэка из трекера с нашими макросами, например: https://tracker.example.com/postback?subid={click_id}&status={conversion_status}&payout={payout}

Сопоставьте эти статусы с названиями в своём трекере (например, approved → hold). Кнопка «Проверить» отправляет тестовый постбэк — подключение видно сразу. В истории отправок виден каждый запрос и ответ трекера.

Шаг 3: отправляйте заказы со своего сайта

Форма на вашем лендинге может отправлять заказ напрямую в платформу: в запрос POST /api/v1/orders передаются ID потока, телефон и имя клиента, при желании — click_id или номер заказа в вашей системе. Дальше заказ, как обычно, уходит оператору, а статус возвращается через постбэк или вебхук.

• Возможность открывается партнёрам, у которых есть минимум 3 доставленных заказа — это защита от фейковых заказов.
• Один номер не может дважды заказать один и тот же товар в течение 24 часов — так же, как на сайте.
• С заголовком Idempotency-Key повторная отправка запроса не создаст дубль.

Полное описание, примеры и код проверки подписи вебхука: документация API.

Шаг 4: подключите AI-ассистента (MCP)

MCP (Model Context Protocol) — стандарт подключения AI-ассистентов к внешним системам. MCP-адрес Birinchi Shop: https://birinchishop.uz/api/v1/mcp. Подключённый ассистент ищет товары, сравнивает процент продаж, создаёт ссылки и анализирует статистику — по задаче, сформулированной обычными словами.

Claude.ai или ChatGPT (без ключа): в Claude.ai — Settings → Connectors → Add custom connector; в ChatGPT сначала включите Settings → Apps & Connectors → Advanced settings → Developer mode и нажмите Create (Authentication: OAuth). Укажите адрес выше и нажмите Connect (на платных тарифах приложений). Откроется панель Birinchi Shop: войдите, выберите разрешения и подтвердите паролем. Подключённое приложение видно в разделе «API» панели, отключить его можно в любой момент.

Для программ вроде Claude Code создайте в панели отдельный ключ. Давайте AI обычно только разрешения на просмотр, разрешение на отправку заказов не давайте.

Безопасность

• Сам ключ не хранится в базе, только его хеш — его не могут увидеть даже сотрудники платформы.
• Отдельный ключ на каждую интеграцию: при проблеме отзываете только его.
• Номер телефона клиента и в API, и в постбэке передаётся в скрытом виде (последние 4 цифры).
• Есть лимиты на число запросов и журнал безопасности: кто, когда и с какого IP.

Частые вопросы