> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.6mm.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.6mm.com/_mcp/server.

# 6MM Agent SDK

> Используйте 6MM Agent SDK для подписанных API-вызовов из Java- и PHP-бэкендов, привязки пользователей, переводов активов, создания URL входа в торговлю, идемпотентной обработки и проверки вебхуков.

Этот 6MM Agent SDK предназначен для партнёрских серверов, которым необходимо вызывать привилегированный агент API без внедрения подписи и обработки запросов с нуля. Он не должен работать в браузере, мобильном или публичном рабочем столе, поскольку интеграция использует партнёрский API секрет.

<h2 id="when-to-use-the-agent-sdk">
  Когда использовать Agent SDK
</h2>

Используйте Agent SDK, когда вашему бэкенду необходимо связать пользователя партнёра, перемещать активы в рамках утверждённого рабочего процесса, запрашивать торговые записи, создавать URL для входа во встроенную торговлю или проверять уведомления Webhook. Используйте [Trading Widget SDK](/ru/sdk/trading-widget/overview) отдельно, когда партнёрский фронтенд должен отображать торговый интерфейс.

<h2 id="capabilities">
  Возможности
</h2>

| Сценарий                    | Java SDK       | PHP SDK        |
| --------------------------- | -------------- | -------------- |
| Пользователь привязки       | Поддерживается | Поддерживается |
| Перевод фиксированной суммы | Поддерживается | Поддерживается |
| Переведите всё              | Поддерживается | Поддерживается |
| Обратная передача           | Поддерживается | Поддерживается |
| Ордер запросов              | Поддерживается | Поддерживается |
| Создать запись URL          | Поддерживается | Поддерживается |
| Проверка с помощью вебхука  | Поддерживается | Поддерживается |

<h2 id="common-configuration">
  Общая конфигурация
</h2>

| Ключ            | Пример                                                                             | Описание                                                  |
| --------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------- |
| baseUrl         | `https://agent-api.6mm.com`                                                        | 6MM Агент API сервис URL без слэша.                       |
| agentCode       | AGENT001                                                                           | Код агента партнёра.                                      |
| apiSecret       | ваша-апи-секрета                                                                   | API секрет подписи, хранящийся только на бэкенде.         |
| defaultCurrency | USDT                                                                               | Валюта по умолчанию для перевода и API счёта.             |
| webhookUrl      | [https://partner.example.com/6mm/webhook](https://partner.example.com/6mm/webhook) | Партнерская конечная точка для 6MM уведомлений о вебхуке. |

<h2 id="typical-integration-flow">
  Типичный поток интеграции
</h2>

1. Партнерский фронтенд аутентифицирует пользователя через собственную систему аккаунта партнёра.
2. Партнёрский бэкенд отображает пользователя на стабильный идентификатор партнёрской стороны.
3. Бэкенд вызывает Agent SDK с `agentCode` и защищённым API секретом.
4. SDK подписывает и отправляет агенту API запрос.
5. Бэкенд хранит возвращённый бизнес-идентификатор и идемпотентно обрабатывает последующие вебхуки.
6. Фронтенд получает только кратковременный результат или учетные данные, которые ему нужны.

<h2 id="choose-an-sdk">
  Выберите SDK
</h2>

| Стек бэкенде | Начните здесь                                                                                                |
| ------------ | ------------------------------------------------------------------------------------------------------------ |
| Java         | [Java SDK Обзор](/ru/sdk/agent-sdk/java/overview) и [Java Быстрый старт](/ru/sdk/agent-sdk/java/quick-start) |
| PHP          | [PHP SDK Обзор](/ru/sdk/agent-sdk/php/overview) и [PHP Быстрый старт](/ru/sdk/agent-sdk/php/quick-start)     |

<h2 id="production-checklist">
  Чек-лист производства
</h2>

* Загружать `apiSecret` из бэкенд-менеджера секретов, а не из исходного кода.
* Разделять разработку, постановку и производственные сертификаты.
* Использовать стабильное партнёрское пользовательское отображение и уникальные идентификаторы бизнес-ордера.
* Сохранить исходный идентификатор при проверке статуса запроса с тайм-аутом.
* Проверка подписей вебхуков и хранение обработанных идентификаторов событий.
* Редактировать секреты и подписи из журналов, сохраняя идентификаторы запросов для поддержки.

<h2 id="next-steps">
  Следующие шаги
</h2>

#### [Java Быстрый старт](/ru/sdk/agent-sdk/java/quick-start)

Установите и инициализируйте Agent SDK в Java бэкенде.

#### [PHP Быстрый старт](/ru/sdk/agent-sdk/php/quick-start)

Установите и инициализируйте Agent SDK в PHP бэкенде.

#### [Вебхуки и идемпотентность](/ru/sdk/security/webhooks-idempotency)

Проверяйте обратные вызовы и предотвращайте дублирование бизнес-обработки.