Birinchi Shop

Журнал изменений и политика версий API

Для партнёров, разработчиков и владельцев трекеров: технические изменения платформы с датами, самые новые сверху. Отметка «затрагивает /api/v1» стоит у записей, где изменился ответ или поведение API. Ниже — правила того, как меняется версия API.

Бесплатная регистрация
1 минута · без карты и документов
30 000+сум за каждый доставленный заказ
14 минмедианное время выплаты (90 дней)
350+активных товаров
0 сумвложений для старта
Данные на 2026-11-21. Срок выплаты — в течение 1 дня; 14 мин — фактическая медиана за 90 дней. Как считаются цифры

Изменения

Новые возможности и объявления для партнёров — Новости платформы.

  1. Интеграция
    Коннектор для n8n и SDK 0.2.0

    Вышел официальный коннектор для n8n: npm-пакет n8n-nodes-birinchishop (действия и вебхук-триггер с проверкой подписи; устанавливается через n8n → Settings → Community nodes). SDK 0.2.0 для Node.js и Python (npm, PyPI): режим тестового ключа, смена статуса тестового заказа, отдельные классы ошибок. GitHub · Документация API

  2. Интеграция
    Уведомления в браузере (Web Push)

    В панели партнёра личные уведомления (заказ принят, доставлен, доход) теперь приходят, даже когда браузер закрыт: Профиль → Уведомления в браузере. Какие уведомления получать (заказы, вывод средств, бонусы, реклама, офферы, советы), вы выбираете сами. Стандартный Web Push; на iPhone панель должна быть добавлена на главный экран. После выхода из аккаунта или завершения сеанса устройства уведомления на него не отправляются. Технические возможности

  3. API затрагивает /api/v1
    Когортный анализ и отчёт мультитач-атрибуции

    Два новых отчёта в статистике. Когортный анализ: по неделе создания заказа, доля доставленных за 3, 7, 14 и 30 дней (GET /stats/cohorts). Мультитач-атрибуция: первое, последнее и вспомогательные касания для заказа, пришедшего по ссылке или лендингу (GET /stats/attribution); для этого в браузере покупателя ставится собственная cookie без персональных данных (п. 5.3 политики конфиденциальности). Правило выплат не менялось: заказ засчитывается ссылке, через которую оформлен. Технические возможности · Документация API

  4. Документация
    Официальный PHP SDK (beta)

    Официальная библиотека для PHP 8.1+, версия 0.1.0: без зависимостей, все методы API, безопасные повторы, Idempotency-Key, проверка подписи вебхука и режим тестового ключа (bsk_test_). Установка: composer require birinchishop/birinchishop. Исходный код: github.com/Birinchishop/birinchishop-php. GitHub · Документация API

  5. Безопасность
    Активные устройства, история входов, выгрузка данных, HSTS preload

    Новые разделы в профиле: список устройств, на которых открыт аккаунт, и завершение сеансов, история входов, уведомление о входе с нового устройства; выгрузка своих данных одним JSON-файлом (номер клиента и номера документов замаскированы). Сайт отправлен в список HSTS preload; основной сервер теперь принимает только соединения с сертификатом CDN. Независимые оценки: Mozilla Observatory A+ (115 баллов), Qualys SSL Labs A+. Технические возможности · Защита данных

  6. MCP / AI
    A2A (Agent2Agent 1.0): агенты магазина и партнёров

    Другие AI-агенты теперь подключаются к платформе по протоколу A2A. Агент магазина открыт: карточка /.well-known/agent-card.json, эндпоинт /api/a2a/shop (JSON-RPC и HTTP+JSON). Агент партнёров: карточка /api/a2a/partner/agent-card.json, доступ по API-ключу или OAuth; права и тестовый режим те же, что в API v1. Заказ оформляется только после явного подтверждения покупателя. Стриминга и push-уведомлений нет. Технические возможности · Документация API

  7. Безопасность
    Вход без пароля по passkey

    Вход в панель партнёра в браузере по отпечатку пальца, Face ID или блокировке экрана (WebAuthn). Passkey добавляется, переименовывается и удаляется в профиле; добавление — в течение 10 минут после входа или с текущим паролем. При сбросе пароля passkey удаляются. В Android-приложении пока нет. Технические возможности · Защита данных

  8. API затрагивает /api/v1
    Вероятность продажи: ML-модель

    Вероятность продажи нового заказа теперь даёт ML-модель, обученная на истории наших заказов (переобучение каждую неделю). В список factors в ответе API v1 и MCP добавлен новый фактор: ml (значение и основные причины). Для новых заказов процент ниже прежнего и ближе к реальной доставке. Оценка носит справочный характер. Технические возможности · Документация API

  9. Документация
    Официальные SDK для Node.js и Python (beta, npm и PyPI), коллекция Postman, инструкция для Binom

    Официальные SDK, версия 0.1.0 (beta): Node.js 18+ (без зависимостей, типы TypeScript, проверка подписи вебхука) и Python 3.8+ (только стандартная библиотека, type hints). Опубликованы в npm и PyPI: npm install birinchishop, pip install birinchishop; исходный код — на GitHub. В репозиторий примеров добавлены коллекция Postman и инструкция по подключению Binom. npm · PyPI · Node.js SDK · Python SDK · Postman · Binom

  10. Трекинг затрагивает /api/v1
    Макрос постбэка {payout_earned}

    Новый макрос: сумма выплаты только при conversion_status=sale (доставлен), при остальных статусах 0. Используйте его для дохода в трекере. {payout} не изменился — выплата по товару при любом статусе. Руководство по постбэкам · Документация API

  11. API затрагивает /api/v1
    Тестовый режим API (sandbox)

    В панели создаётся тестовый ключ (bsk_test_…). Запросы на чтение возвращают реальные данные; POST /orders и POST /links проходят те же проверки, что и с боевым ключом, но заказ или ссылка не создаются и никому не звонят — в ответе "test": true и заголовок X-Birinchishop-Mode: test. После тестового заказа приходит подписанный тестовый вебхук (order.created); POST /api/v1/sandbox/orders/{id}/status имитирует смену статуса (вебхук и постбэк, новый макрос {test} = 1). Тестовые объекты хранятся 24 часа (при перезапуске сервера удаляются); тестовый ключ не может управлять рекламой; MCP работает и с тестовым ключом. guide.md · Документация API · OpenAPI

  12. Инфраструктура
    Начатые запросы не обрываются при перезапуске (graceful restart)

    При обновлении сервер останавливается плавно: не принимает новые соединения, доводит начатые запросы (например, создание заказа) до конца, корректно закрывает соединения реального времени (SSE), и панель переподключается сама. Раньше процесс мог остановиться сразу и оборвать выполняемый запрос. Эффект на проде ещё не измерен. /status

  13. Документация
    Юридические документы на ru/en по отдельным адресам

    Русский и английский тексты договора о сотрудничестве, публичной оферты и политики конфиденциальности теперь по своим адресам (/ru/…, /en/partner-agreement, /en/public-offer, /en/privacy-policy) и полностью читаются без JS. Договор о сотрудничестве · Публичная оферта · Политика конфиденциальности

  14. Документация
    Критерии технической оценки, журнал изменений и политика по уязвимостям

    Опубликованы нейтральные критерии технической оценки CPA-сети (с ответом Birinchi Shop и ссылкой-подтверждением по каждому), этот журнал и политика версий API, политика сообщения об уязвимостях. Критерии технической оценки · Политика по уязвимостям · security.txt

  15. MCP / AI
    MCP: протокол 2026-07-28 и примеры инструментов

    MCP-серверы для партнёров и магазина поддерживают протокол MCP 2026-07-28 (вместе с 2025-11-25 и более ранними — для существующих клиентов ничего не изменилось). В описания инструментов добавлены примеры; версия MCP-сервера партнёров — 1.2.0. mcp.json · guide.md

  16. Трекинг
    Реальное время в панели (SSE)

    Открытая панель сама показывает новый заказ, смену статуса, баланса и уведомления за 1–2 секунды (Server-Sent Events). При обрыве панель переподключается сама; запасное обновление каждые 60 секунд сохранено. Технические возможности

  17. Инфраструктура
    Резервный сервер и ежечасные копии

    На отдельном резервном сервере — живая копия базы (задержка несколько секунд); база копируется каждый час в зашифрованном виде; файлы, код и настройки копируются на резервный сервер раз в час; при сбое — предупреждение. Переход на резервный сервер выполняется вручную. Технические возможности

  18. Инфраструктура
    Независимый мониторинг доступности

    Внешний сервис мониторинга проверяет сайт, API и панель каждые 5 минут; открытая страница статуса — /status. /status · Технические показатели

  19. API затрагивает /api/v1
    API /stats: дни по ташкентскому времени

    Группировка по дням (статистика панели и API /stats, group_by=day) теперь считается по ташкентскому времени. Раньше часть заказов после полуночи попадала в предыдущий день. Документация API

  20. Трекинг затрагивает /api/v1
    Журнал кликов; clicks и unique_clicks в API /stats

    Каждый клик пишется в журнал: боты, превью ссылок и предзагрузка отделяются, уникальные клики (окно 30 минут), CR за период; сырой IP не хранится. В ответ API /stats добавлены поля clicks и unique_clicks. Начато измерение «точности трекинга». Технические показатели · Документация API

  21. API затрагивает /api/v1
    Правило «заказ в работе» и защита от двойной отправки

    Для части товаров новый заказ не принимается, пока прежний заказ клиента на этот товар в работе — API возвращает 409 с кодом order_in_process. Одновременная двойная отправка создаёт один заказ. Документация API · Технические показатели

  22. Документация
    Страницы «Технические показатели» и «Технические возможности»

    Открытые технические показатели (время ответа API P50/P95, доля 5xx, доставка постбэков, доля дублей, свежесть статусов, скорость выплат) с методикой и в JSON (/api/public/tech-metrics); все технические возможности — в таблице «есть / частично / нет». Технические показатели · Технические возможности

  23. Интеграция
    Meta Conversions API: событие Delivered

    При доставке заказа клиенту в Meta отправляется отдельное событие Delivered (в датасет партнёра, пиксель лендинга и сайта) — для оптимизации на реальные продажи. guide.md

  24. API затрагивает /api/v1
    API: название и описание товара на ru/en (?lang)

    GET /offers и GET /offers/{id} принимают необязательный параметр lang=uz|ru|en; если перевода нет, возвращается узбекский текст. Документация API

  25. API затрагивает /api/v1
    API: умный поиск товаров

    GET /offers?search= понимает синонимы, опечатки, кириллицу и латиницу; без sort результаты упорядочены по релевантности. Документация API

  26. Документация
    Открытый репозиторий на GitHub: примеры API

    Примеры на curl, Node.js, Python и PHP, проверка подписи вебхука, инструкция по постбэку для Keitaro, подключение MCP и копия OpenAPI. GitHub

  27. Интеграция
    Интеграция с Targenix

    Лиды из Targenix приходят через вебхук и становятся заказами (по ID ссылки или полной ссылке); статусы заказов возвращаются в Targenix. Технические возможности

  28. Безопасность
    Страница «Защита данных»

    Как защищены пароли, платёжные документы, номер клиента, сессии и API-ключи — на открытой странице. Защита данных

  29. API затрагивает /api/v1
    Запрет заказа на свой номер

    Партнёр не может оформить заказ на свой номер телефона: проверка в панели, API, AI-чате и форме ссылки; API возвращает 422 с кодом own_phone. Документация API

  30. MCP / AI
    MCP магазина: интерактивное окно

    В MCP-сервере магазина — интерактивное окно товаров прямо в AI-чате (MCP Apps); отдельный вариант для ChatGPT. Заказ через AI

  31. MCP / AI
    MCP Registry и mcp.json

    MCP-сервер магазина опубликован в официальном MCP Registry (uz.birinchishop/shop); список серверов — в /.well-known/mcp.json. mcp.json

  32. Документация
    Руководство для AI-помощников по коду

    /api/v1/guide.md — один файл, собираемый из живой схемы OpenAPI: его можно передать Claude, ChatGPT или Cursor и попросить написать интеграцию. guide.md

  33. API затрагивает /api/v1
    API: AI-менеджер и эндпоинты рекламы Meta

    Новые права insights:read, ads:read, ads:write; /insights, /orders/{id}/sale-chance, /ads/*, /actions/{id}. Пауза рекламы — сразу; включение и изменение бюджета возвращают 202 и pending_confirmation — подтверждает партнёр. В MCP добавлены prompts и resources. Версия схемы: 2026-10-23. Документация API · OpenAPI

  34. MCP / AI
    MCP-сервер магазина для покупателей

    /api/shop/mcp — без ключа: поиск товаров, карточка товара, оформление заказа (только после явного согласия покупателя) и статус заказа. Заказ через AI

  35. Безопасность
    Подключение AI через OAuth 2.1; /.well-known

    Коннекторы Claude.ai и ChatGPT подключаются к MCP-серверу партнёров без ключа, через OAuth 2.1 (PKCE) — подключение партнёр подтверждает в панели. В /.well-known — метаданные OAuth, mcp.json и security.txt. mcp.json · security.txt

  36. Безопасность
    API-ключи: подтверждение и автоматический отзыв

    Создание ключа подтверждается паролем или кодом из Telegram; при сбросе пароля все API-ключи автоматически отзываются. Защита данных

  37. API затрагивает /api/v1
    Запущен открытый API v1

    REST API (товары, ссылки, заказы, статистика, лента событий), JSON-вебхуки с подписью HMAC, S2S-постбэк (с макросами, до 8 повторов), click_id и sub1–sub5, Idempotency-Key, MCP-сервер партнёров и схема OpenAPI. Документация API · OpenAPI

В журнал попадают технические изменения, заметные партнёру. Внутренние работы и подробности исправлений безопасности не публикуются.

Политика версий API

  • Основная версия — в пути. Сейчас одна версия: /api/v1. В каждом ответе есть заголовок X-API-Version: v1.
  • Дата схемы. info.version в OpenAPI и поле api_version в сообщении вебхука показывают дату редакции схемы (сейчас 2026-10-23). Мелкие добавления не всегда меняют эту дату — точный список в этом журнале.
  • Внутри v1 — только добавляющие изменения. Новый эндпоинт, необязательный параметр, новое поле в ответе, новый тип события или код ошибки. С запуска 2026-10-22 в v1 не удалено и не переименовано ни одного эндпоинта или поля.
  • Что ожидается от клиента. Игнорируйте незнакомые поля в ответе и ориентируйтесь на error.code, а не на текст сообщения.
  • Несовместимые изменения. Удаление поля или эндпоинта, смена имени или типа внутри v1 не делаются — это будет новая основная версия, о которой заранее сообщим в этом журнале. Планов на v2 пока нет, поэтому конкретный срок вывода из эксплуатации не установлен.
  • Исключение. Изменение ради безопасности и защиты персональных данных (например, маскирование значения поля) может быть внесено без предупреждения. Бизнес-правила (правило дублей, условия отправки заказов) тоже могут меняться — они возвращаются новым кодом ошибки и записываются сюда.
  • MCP. MCP-серверы одновременно поддерживают несколько версий протокола (сейчас 2026-07-28, 2025-11-25 и более ранние); версия сервера — в serverInfo.version.

Начните сегодня

Зарегистрируйтесь, выберите товар и получите первую ссылку.

Стать партнёром

Как следить за изменениями

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

Какая сейчас версия API Birinchi Shop?

v1 (/api/v1, в каждом ответе X-API-Version: v1). Дата схемы — в info.version OpenAPI и в поле api_version вебхука, сейчас 2026-10-23.

Сломается ли интеграция при изменении API v1?

Внутри v1 делаются только добавляющие изменения: новый эндпоинт, необязательный параметр, новое поле или код ошибки. С 2026-10-22 ни один эндпоинт или поле не удалены. Игнорируйте незнакомые поля и ориентируйтесь на error.code.

Что будет при несовместимом изменении?

Оно не вносится внутри v1 — выйдет новая основная версия, о которой заранее сообщим в этом журнале. Планов на v2 пока нет.

Что не попадает в журнал?

Внутренние и административные работы, а также подробности исправлений безопасности. Заметные партнёру технические изменения — API, MCP, трекинг, интеграции, инфраструктура — записываются с датой.

Доход с каждого доставленного заказа

Склад, курьеры и операторы — на нас. От вас — только реклама.

Бесплатная регистрация

Читайте также

Все статьи →