Hướng dẫn Tích hợp Webhook

Tài liệu này hướng dẫn các bước cần thiết để tích hợp và nhận tín hiệu giao dịch từ nebula. Quy trình tích hợp bao gồm 3 bước chính:

Cấu hình API Webhook

Trước tiên, bạn cần xây dựng một API endpoint (API Webhook) để sẵn sàng nhận dữ liệu từ nebula.

Endpoint này phải có khả năng tiếp nhận yêu cầu POST với Content-Type: application/json và phản hồi với HTTP Status Code 200 OK để xác nhận đã nhận dữ liệu thành công.

Để xem chi tiết về cấu trúc request body mà Nebula sẽ gửi, vui lòng tham khảo tài liệu: Nhận Tín hiệu mua bán của nebula

Cung cấp thông tin Endpoint

Sau khi đã chuẩn bị API Webhook, vui lòng cung cấp cho Simplize các thông tin API Webhook qua email hoặc ticket để tiến hành cấu hình.

Bạn có thể sử dụng mẫu sau để gửi cho Simplize:

Chủ đề: Cấu hình Webhook

- Endpoint URL: https://api.doitac.com/webhook/signals
- Authentication:
  - Auth Type: API_KEY
  - Vị trí: Header
  - Tên Key: X-API-Key
  - Giá trị Key: sk_live_xxxxxxxxxxxx

Kiểm tra tích hợp

Sau khi Simplize xác nhận đã hoàn tất cấu hình, bạn có thể chủ động kiểm tra tích hợp bằng cách gọi API test. API này sẽ mô phỏng việc có tín hiệu mới và kích hoạt webhook đến API Webhook của bạn.

Để xem chi tiết về cách gọi API test, vui lòng tham khảo tài liệu: Gửi Tín hiệu Webhook Test

Kiểm tra kết quả

1. Gọi API test: Nếu yêu cầu hợp lệ, bạn sẽ nhận được response 200 OK.
2. Kiểm tra API Webhook: Ngay sau đó, API Webhook của bạn sẽ nhận được một POST request từ nebula.
3. Xác thực Payload: Kiểm tra xem body của request nhận được có đúng format và chứa dữ liệu bạn đã gửi trong API test hay không.

Nếu API Webhook của bạn nhận được cuộc gọi với dữ liệu chính xác, quá trình tích hợp đã thành công.