Bảo mật & Vận hành

SDK Khắc phục sự cố tích hợp

Chẩn đoán các vấn đề Trading Widget, Agent SDK, ký, webhook, timeout và môi trường trước khi chuyển yêu cầu hỗ trợ.

View as Markdown

Bắt đầu với môi trường, dấu thời gian và định danh doanh nghiệp cho thao tác thất bại. Kiểm tra có cấu trúc thường tách biệt các vấn đề cấu hình khỏi các vấn đề xác thực, mạng và xử lý bất đồng bộ.

Thứ tự chẩn đoán được khuyến nghị

  1. Xác nhận môi trường bị ảnh hưởng và URL cơ sở.
  2. Ghi lại khoảng thời gian UTC và yêu cầu thất bại đầu tiên.
  3. Xác định module: Trading Widget, Agent SDK, REST API, WebSockethoặc webhook.
  4. Ghi lại ID yêu cầu, ID người dùng đối tác, agentOrderNo, ID đơn hàng hoặc ID sự kiện webhook.
  5. Kiểm tra mã nguồn gần đây, thông tin đăng nhập, danh sách trắng IP hoặc thay đổi triển khai.
  6. Tái tạo bằng hộp thử nhỏ nhất an toàn.

Vấn đề Trading Widget

Triệu chứngNguyên nhân có thể xảy raSửa lỗi
miền cục bộ đối tác yêu cầu iframebaseUrl bị thiếuPass baseUrl: ‘https://app.6mm.com’.
iframe không hiển thị hoặc rất ngắnContainer cha không có chiều caoThiết lập chiều cao container hoặc chiều cao qua.
token_provider_missingchế độ partner-token không có nhà cung cấpThêm xác thực.tokenProvider.
auth_exchange_failedMã nhúng không hợp lệ, hết hạn hoặc không khớpKiểm tra phản hồi token backend và channelId.

Vấn đề Agent SDK

Triệu chứngNguyên nhân có thể xảy raSửa lỗi
Chữ ký bị từ chốiSai bí mật, lệch đồng hồ hoặc thay đổi thủ công các trường đã kýCho phép SDK tạo trường ký và đồng bộ thời gian máy chủ.
Rủi ro di chuyển quỹ trùng lặpSố đơn hàng mới được sử dụng sau khi hết thời gian chờTruy vấn theo agentOrderNo gốc trước.
PROCESSING bị coi là thất bạiTình trạng đang chờ xử lý bị hiểu nhầmChờ webhook hoặc gọi queryOrder.
Webhook đã được xử lý nhiều lầnHành vi thử lại mà không có idempotencyThêm khóa bất lực và kiểm tra trạng thái cuối cùng.

Bằng chứng cần bắt giữ

Tích hợpBằng chứng hữu ích
Trading WidgetTrang URL, đường dẫn phiên bản SDK , bảng điều khiển trình duyệt, các yêu cầu mạng thất bại, payload onError và kích thước container.
Agent SDKSDK ngôn ngữ/phiên bản, URL cơ bản, dấu thời gian UTC , ID yêu cầu, agentOrderNo, mã phản hồi và nhật ký đã được làm sạch.
WebhookThời gian gửi, khóa sự kiện hoặc khóa kinh doanh, kết quả xác thực chữ ký, trạng thái xử lý và hàm băm cơ thể thô đã được làm sạch.
REST APIPhương thức, đường dẫn, môi trường, ID yêu cầu, mã phản hồi và các tham số đã được làm sạch.

Không bao giờ đưa mật khẩu, mã truy cập, bí mật API , chữ ký đầy đủ, khóa riêng tư hoặc dữ liệu cá nhân không bị che giấu trong chẩn đoán.

Trước khi leo thang

  • Chỉ thử lại khi thao tác được ghi nhận là an toàn để thử lại.
  • Sau một thời gian chờ, hãy truy vấn định danh doanh nghiệp gốc thay vì tạo mới.
  • Xác nhận môi trường đồng hồ hệ thống và thông tin đăng nhập để phát hiện lỗi chữ ký.
  • Giữ nguyên thất bại đầu tiên và bất kỳ kết quả thử lại nào sau đó.
  • Sử dụng Mẫu Yêu Cầu Hỗ Trợ để gửi báo cáo đầy đủ, đã được bôi đen.
Trading Widget Khởi Đầu Nhanh

Xác minh việc tải script, kích thước container, cấu hình và callback.

Bí mật & Ký kết

Kiểm tra thông tin đăng nhập Agent SDK , đồng hồ và các trường đã ký.

Webhooks & Idmpotency

Xem xét xác minh callback và xử lý sự kiện trùng lặp.