Безопасность и эксплуатация

SDK Устранение неполадок интеграции

Диагностируйте Trading Widget, Agent SDK, подписы, вебхук, тайм-аут и проблемы с окружающей средой, прежде чем подавать запрос в поддержку.

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

Начните с среды, временной метки и бизнес-идентификатора для неудачной операции. Структурированная проверка обычно отделяет проблемы конфигурации от аутентификации, сетевых и асинхронной обработки.

Рекомендуемый диагностический порядок

  1. Подтвердить затронутую среду и базовую URL.
  2. Запишите UTC временной диапазон и первый неудачный запрос.
  3. Определите модуль: Trading Widget, Agent SDK, REST API, WebSocketили webhook.
  4. Зафиксировать идентификатор запроса, идентификатор пользователя партнёра, agentOrderNo, ID заказа или идентификатор события вебхука.
  5. Проверьте недавний код, учетные данные, IP белый список или изменения в развертывании.
  6. Воспроизводите с помощью наименьшего безопасного тестового случая.

Trading Widget проблемы

СимптомВероятная причинаИсправление
iframe запрашивает партнёра в локальном доменеbaseUrl отсутствуетPass baseUrl: ‘https://app.6mm.com’.
iframe невидим или очень короткийРодительский контейнер не имеет высотыУстановите высоту контейнера или высоту прохода.
token_provider_missingРежим Partner-Token не имеет провайдераДобавьте авторизациюtokenProvider.
auth_exchange_failedНедействительный, истекший или несовпадающий встраиваемый токенПроверьте отклик токена на бэкенде и channelId.

Agent SDK проблемы

СимптомВероятная причинаИсправление
Подпись отклоненаНеправильный секрет, смещение часов или ручное изменение подписанных полейПозвольте SDK генерировать поля подписи и синхронизировать время сервера.
Риск перемещения дублирующих средствНовый номер заказа используется после тайм-аутаСначала запросите по оригинальным agentOrderNo .
PROCESSING считали неудачейОжидающее государство неправильно понятоПодождите вебхук или вызовите queryOrder.
Webhook обрабатывается многократноПовторяйте поведение без идемпотентностиДобавьте ключ идемпотентности и проверки конечного состояния.

Доказательства для захвата

ИнтеграцияПолезные доказательства
Trading WidgetСтраница URL, SDK путь версии, консоль браузера, неудачные сетевые запросы, onError полезная нагрузка и размеры контейнеров.
Agent SDKSDK языке/версии, базовой URL, UTC временной меткой, идентификатором запроса, agentOrderNo, кодом ответа и очищенными журналами.
ВебхукВремя доставки, событие или бизнес-ключ, результат проверки подписи, состояние обработки и очищенный raw body hash.
REST APIМетод, путь, среда, идентификатор запроса, код ответа и очищенные параметры.

Никогда не включайте в диагностику пароли, токены доступа, API секреты, полные подписи, приватные ключи или неотредактированные персональные данные.

Перед эскалацией

  • Повторять только тогда, когда операция задокументирована как безопасная для повторного попробовки.
  • После тайм-аута запросите исходный бизнес-идентификатор вместо создания нового.
  • Подтверждение системного тактового сигнала и среды учетных данных на наличие ошибок подписи.
  • Сохранить первую неудачу и все последующие повторные попытки.
  • Используйте Шаблон запроса поддержки для отправки полного, отредактированного отчёта.
Trading Widget Быстрый старт

Проверьте загрузку скриптов, размер контейнера, конфигурацию и обратные вызовы.

Секреты и подписания

Проверьте Agent SDK учётные данные, часы и подписанные поля.

Вебхуки и идемпотентность

Проверьте проверку обратного звонка и обработку дублирующих событий.