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

SDK Усунення несправностей інтеграції

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

View as Markdown

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

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

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

Trading Widget проблеми

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

Agent SDK проблеми

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

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

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

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

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

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

Пов’язані документи

Trading Widget Швидкий старт

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

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

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

Webhooks & Ідемпотентність

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

Діагностика Java v0.3.0

СимптомПеревірка і відновлення
Результат запиту на фінансування невідомийЗберегти оригінал agentOrderNo; виклик queryWalletTransfer з вихідним середовищем. Не використовуйте queryOrder.
Інтерфейс моделювання показує несподівані коштиПеревірте інтерфейс tradingMode окремо від бекенда environment; обліковий запис isSimulatedUser не направляє запити.
Помилка запиту 6905Відмовтеся від використання спільної партнерської квоти, а потім повторіть той самий курсор і фільтри через SDK.
Помилка запиту 6904Зменшити кількість одночасних запитів і звузити часове вікно; зв’яжіться зі службою підтримки, якщо це не зникне.
Недійсний або прострочений курсорПерезапустіть те саме вікно фіксованої історії та видаліть дублікати збережених записів.
Відсутній новий метод Java.Перевірте виправлений артефакт Maven на загальнодоступний тег v0.3.0; видаліть конфліктні залежності відповідно до вашої політики артефактів.

Запит і посилання на помилки · Посібник з оновлення

Webhook проблеми з отриманням

СимптомПеревірка та обробка
Без повторної спроби після помилки JSONПеревірте, чи кінцева точка досі повертає HTTP 200. Доставка використовує лише статус HTTP, а не індикатор успіху в тілі.
Повторні спроби триватимуть після 401 або 409Відповіді, відмінні від 2xx, відповідають існуючій політиці повторних спроб; перевірити підписи, вміст сповіщень або конфігурацію продавця.
Порожній ключ ідемпотентності для попередження про ліквідаціюПоточний WebhookVerifier.idempotencyKey витягує лише ідентифікатори коштів і подій. Після перевірки підпису та права власності перевірте notificationId і створіть ключ попередження в коді продавця. Ніколи не використовуйте порожній ключ.
Повторне сповіщення після успішної обробкиЗберігайте дедуплікацію в межах продавця та environment. Повернути 2xx для ідентичних дублікатів; конфлікти записів і повернення не-2xx для того самого ідентифікатора з іншим тілом.
Попередження не обробленоПрийняти liquidation.warning і історичні LIQUIDATION_WARNING; не групуйте окремі ідентифікатори сповіщень за користувачем, епізодом або типом події та відкидайте їх.
Прийняте сповіщення втрачає незавершене завданняНадійно зберегти завдання перед поверненням 2xx; запуску асинхронного завдання в пам’яті недостатньо.

Поля подій і сумісність · HTTP відповіді та надійне підтвердження