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

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

Thứ tự chẩn đoán được đề xuất

Xác nhận môi trường và cơ sở bị ảnh hưởng URL.
Ghi lại phạm vi thời gian UTC và yêu cầu không thành công đầu tiên.
Xác định mô-đun: Trading Widget, Agent SDK, REST API, WebSocket hoặc webhook.
Ghi lại ID yêu cầu, ID người dùng đối tác, agentOrderNo, ID đơn đặt hàng hoặc ID sự kiện webhook.
Kiểm tra mã, thông tin xác thực, danh sách trắng IP gần đây hoặc các thay đổi về triển khai.
Tái tạo với trường hợp thử nghiệm an toàn nhỏ nhất.

triệu chứng	Có khả năng gây ra	Sửa chữa
iframe yêu cầu tên miền địa phương của đối tác	baseUrl bị thiếu	Vượt qua baseUrl: ‘https://app.6mm.com’.
iframe không hiển thị hoặc rất ngắn	Vùng chứa chính không có chiều cao	Đặt chiều cao vùng chứa hoặc chiều cao vượt qua.
token_provider_missing	chế độ mã thông báo đối tác không có nhà cung cấp	Thêm xác thực.tokenProvider.
auth_exchange_fail	Mã thông báo nhúng không hợp lệ, hết hạn hoặc không khớp	Kiểm tra phản hồi mã thông báo phụ trợ và channelId.

Agent SDK vấn đề

triệu chứng	Có khả năng gây ra	Sửa chữa
Chữ ký bị từ chối	Sai bí mật, trôi đồng hồ hoặc thay đổi các trường đã ký theo cách thủ công	Hãy để SDK tạo các trường ký và đồng bộ hóa thời gian của máy chủ.
Rủi ro chuyển động quỹ trùng lặp	Số đơn đặt hàng mới được sử dụng sau khi hết thời gian	Truy vấn theo agentOrderNo gốc trước tiên.
PROCESSING được coi là lỗi	Trạng thái chờ xử lý bị hiểu nhầm	Đợi webhook hoặc gọi queryOrder.
Webhook được xử lý nhiều lần	Thử lại hành vi mà không có sự bình thường	Thêm khóa tạm thời và kiểm tra trạng thái cuối cùng.

Bằng chứng cần nắm bắt

Tích hợp	Bằng chứng hữu ích
Trading Widget	Đường dẫn phiên bản trang URL, SDK, bảng điều khiển trình duyệt, yêu cầu mạng không thành công, tải trọng `onError` và kích thước vùng chứa.
Agent SDK	SDK ngôn ngữ/phiên bản, cơ sở URL, UTC dấu thời gian, ID yêu cầu, `agentOrderNo`, mã phản hồi và nhật ký đã được lọc.
Webhook	Thời gian giao hàng, 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 nội dung thô đã được khử trùng.
REST API	Phươ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 vệ sinh.

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

Trước khi leo thang

Chỉ thử lại khi thao tác được ghi lại là an toàn để thử lại.
Sau khi hết thời gian, hãy truy vấn mã định danh doanh nghiệp ban đầu thay vì tạo mã mới.
Xác nhận đồng hồ hệ thống và môi trường xác thực để tìm lỗi chữ ký.
Giữ nguyên lần thất bại đầu tiên và mọi kết quả thử lại sau đó.
Sử dụng Mẫu yêu cầu hỗ trợ để gửi một báo cáo hoàn chỉnh, được biên tập lại.

Tài liệu liên quan

Trading Widget Bắt đầu nhanh

Xác minh việc tải tập lệnh, kích thước vùng chứa, cấu hình và lệnh gọi lại.

Bí mật & Ký kết

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

Webhooks & Sự bình thường

Xem lại xác minh cuộc gọi lại và xử lý sự kiện trùng lặp.

Java chẩn đoán v0.3.0

triệu chứng	Kiểm tra và phục hồi
Yêu cầu tài trợ có kết quả không xác định	Giữ nguyên `agentOrderNo`; gọi `queryWalletTransfer` với môi trường ban đầu. Không sử dụng `queryOrder`.
Giao diện người dùng mô phỏng hiển thị số tiền bất ngờ	Kiểm tra giao diện người dùng `tradingMode` riêng biệt với phần phụ trợ `environment`; tài khoản `isSimulatedUser` không định tuyến yêu cầu.
Lỗi truy vấn `6905`	Quay lại sử dụng hạn ngạch đối tác được chia sẻ, sau đó thử lại con trỏ tương tự và lọc qua SDK.
Lỗi truy vấn `6904`	Giảm các truy vấn đồng thời và thu hẹp khoảng thời gian; liên hệ với bộ phận hỗ trợ nếu vẫn tiếp tục.
Con trỏ không hợp lệ hoặc đã hết hạn	Khởi động lại cùng một cửa sổ lịch sử cố định và loại bỏ các bản ghi đã lưu trùng lặp.
Thiếu phương thức Java mới	Kiểm tra tạo phẩm Maven đã giải quyết dựa trên thẻ công khai `v0.3.0`; loại bỏ các phụ thuộc xung đột theo chính sách tạo tác của bạn.

Truy vấn và tham chiếu lỗi · Hướng dẫn nâng cấp

Webhook nhận được sự cố

triệu chứng	Kiểm tra và xử lý
Không thử lại sau khi trả về lỗi JSON	Kiểm tra xem điểm cuối có còn trả về HTTP 200 hay không. Việc phân phối chỉ sử dụng trạng thái HTTP chứ không phải chỉ báo thành công trong nội dung.
Việc thử lại tiếp tục sau 401 hoặc 409	Các phản hồi không phải 2xx tuân theo chính sách thử lại hiện có; điều tra chữ ký, nội dung thông báo hoặc cấu hình người bán.
Khóa tạm thời trống để cảnh báo thanh lý	`WebhookVerifier.idempotencyKey` hiện tại chỉ trích xuất danh tính sự kiện quỹ. Sau khi kiểm tra chữ ký và quyền sở hữu, hãy xác thực `notificationId` và tạo khóa cảnh báo trong mã người bán. Không bao giờ sử dụng một phím trống.
Thông báo trùng lặp sau khi xử lý thành công	Liên tục loại bỏ trùng lặp trong phạm vi người bán và `environment`. Trả về 2xx cho các bản sao giống hệt nhau; ghi lại các xung đột và trả về không phải 2xx cho cùng một ID với nội dung khác.
Cảnh báo chưa được xử lý	Chấp nhận `liquidation.warning` và lịch sử `LIQUIDATION_WARNING`; không nhóm các ID thông báo riêng biệt theo người dùng, tập hoặc loại sự kiện và loại bỏ chúng.
Thông báo được chấp nhận sẽ mất tác vụ đang chờ xử lý	Lưu tác vụ một cách đáng tin cậy trước khi trả về 2xx; bắt đầu một tác vụ không đồng bộ trong bộ nhớ là không đủ.

Các trường sự kiện và khả năng tương thích · HTTP phản hồi và xác nhận đáng tin cậy