Безпека та операції

SDK Діагностика інтеграції

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

View as Markdown

Почніть з середовища, часової позначки та ідентифікатора бізнесу для невдалої операції. Структурована перевірка зазвичай розділяє проблеми конфігурації від аутентифікації, мережевої та асинхронної обробки.

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

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

Trading Widget проблеми

СимптомиЙмовірна причинаВиправлення
iframe запитує партнерський локальний доменbaseUrl відсутняПередайте baseUrl: ‘https://app.6mm.com’.
iframe невидимий або дуже короткийБатьківський контейнер не має висотиВстановіть висоту контейнера або висоту проходу.
token_provider_missingРежим Partner-Token не має провайдераДодайте автентифікаціюtokenProvider.
auth_exchange_failedНедійсний, прострочений або невідповідний токен вбудовиПеревірте відповідь бекенд-токена та channelId.

Agent SDK проблеми

СимптомиЙмовірна причинаВиправлення
Підпис відхиленоНеправильний секрет, зсув годинника або ручна зміна підписаних полівДозвольте SDK генерувати поля підписання та синхронізувати час сервера.
Ризик переміщення дублювання коштівНовий номер замовлення використовується після тайм-аутуСпочатку запит за оригінальним agentOrderNo .
PROCESSING вважали проваломНеправильно зрозумілий стан очікуванняЗачекайте на webhook або зателефонуйте queryOrder.
Вебхук оброблявся кілька разівСпробуйте повторити поведінку без ідемпотентностіДодайте ключ ідемпотентності та перевірки фінального стану.

Докази для захоплення

ІнтеграціяКорисні докази
Trading WidgetСторінка URL, SDK шлях версії, консоль браузера, невдалі мережеві запити, onError корисне навантаження та розміри контейнера.
Agent SDKSDK мова/версія, базова URL, UTC часова мітка, ідентифікатор запиту, agentOrderNo, код відповіді та очищені журнали.
WebhookЧас доставки, ключ події або бізнесу, результат валідації підпису, стан обробки та очищений raw body хеш.
REST APIМетод, шлях, середовище, ідентифікатор запиту, код відповіді та прочистлені параметри.

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

Перед ескалацією

  • Спробуйте повторити лише тоді, коли операція задокументована як безпечна для повторної спроби.
  • Після тайм-ауту запитуйте оригінальний бізнес-ідентифікатор замість створення нового.
  • Підтвердити системний тактовий сигнал і середовище облікових даних на наявність помилок підпису.
  • Зберегти першу невдачу та будь-які наступні результати повторних спроб.
  • Використовуйте Шаблон запиту підтримки для надсилання повного, відредагованого звіту.
Trading Widget Швидкий початок

Перевірте завантаження скриптів, розмір контейнера, конфігурацію та зворотні виклики.

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

Перевірте Agent SDK облікові дані, годинники та підписані поля.

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

Перегляньте перевірку зворотного дзвінка та обробку дублювання події.