Перейти к навигации
Agent SDK

6MM Agent SDK

Просмотр в формате Markdown

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

Когда использовать Agent SDK

Используйте Agent SDK, когда вашему бэкенду необходимо связать пользователя партнёра, перемещать активы в рамках утверждённого рабочего процесса, запрашивать торговые записи, создавать URL для входа во встроенную торговлю или проверять уведомления Webhook. Используйте Trading Widget SDK отдельно, когда партнёрский фронтенд должен отображать торговый интерфейс.

Возможности

СценарийJava SDK
Привязать пользователяПоддерживается
Перевод фиксированной суммыПоддерживается
Перевести всеПоддерживается
Обратный переводПоддерживается
Запрос заказов на перемещениеПоддерживается
Создать запись URLПоддерживается
Webhook проверкаПоддерживается

Общая конфигурация

КлючПримерОписание
baseUrlhttps://agent-api.6mm.com6MM Служба агента API URL без косой черты в конце.
agentCodeAGENT001Код агента-партнера.
apiSecretваш-api-секретAPI секрет подписи хранится только на серверной стороне.
defaultCurrencyUSDTВалюта по умолчанию для перевода и счета APIs.
webhookUrlhttps://partner.example.com/6mm/webhookКонечная точка партнера для уведомлений 6MM webhook.

Типичный процесс интеграции

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

Выберите SDK

Серверный стекНачните здесь
JavaJava SDK Обзор и Java Быстрый старт

PHP SDK не был опубликован публично. Чтобы интегрировать его, свяжитесь с нами, чтобы получить SDK, инструкции по установке и доступные версии.

PHP SDK информация об интеграции

Контрольный список производства

  • Загрузите apiSecret из внутреннего диспетчера секретов, а не из исходного кода.
  • Храните учетные данные разработки, подготовки и производства отдельно.
  • Используйте стабильное сопоставление пользователей-партнеров и уникальные идентификаторы бизнес-заказов.
  • Сохраняйте исходный идентификатор при проверке статуса запроса с истекшим временем ожидания.
  • Проверьте подписи webhook и сохраните идентификаторы обработанных событий.
  • Удаляйте секреты и подписи из журналов, сохраняя при этом идентификаторы запросов на поддержку.

Следующие шаги

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

Установите и инициализируйте Agent SDK в серверной части Java.

Webhooks и идемпотентность

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

PHP SDK Информация об интеграции

PHP SDK не был опубликован публично. Чтобы интегрировать его, свяжитесь с нами, чтобы получить SDK, инструкции по установке и доступные версии.

Возможности Java SDK v0.3.0

Java SDK теперь включает в себя кошельки финансирования, явные среды фондов, шесть запросов к постоянным данным и базовые процентные ставки.

Бизнес-процессJava руководство по v0.3.0
Обязательные и контрактные/финансовые активыПользователи и активы
Передача контракта и запросы заказа на передачуКонтрактные трансферы
Денежные переводы и специальные запросы на восстановлениеФинансирование кошелька
Текущие/исторические заказы, исполнения, позиции и бухгалтерская книгаПостоянные запросы
Перенаправление и встраивание секундной торговлиТорговля секундами
Производственные и моделируемые фондыРуководство по окружающей среде
Обновление существующей интеграции JavaОбновление до версии 0.3.0