Hỗ trợ và phản hồi
Cách báo cáo vấn đề về API hoặc dữ liệu, và cần cung cấp những gì để có thể truy vết.
Báo cáo vấn đề
Hãy dùng trang liên hệ của trang này. Báo cáo có đủ các mục dưới đây thường được truy vết xong trong một lượt.
- URL yêu cầu đầy đủ và thời điểm gọi theo UTC.
- Header phản hồi X-Request-Id, hoặc request_id trong nội dung lỗi.
- Bạn mong đợi gì và đã nhận được gì. Với câu hỏi về dữ liệu: sàn, hợp đồng và con số bạn dùng để đối chiếu, kèm thời điểm ghi nhận con số đó.
Trước khi báo cáo
- Xem trang trạng thái để biết có sự cố nào đang diễn ra không. Trạng thái →
- Xem ma trận chất lượng dữ liệu của sàn và nhóm dữ liệu liên quan. Xếp loại STALE hoặc UNAVAILABLE giải thích phần lớn các giá trị bị thiếu. Chất lượng dữ liệu →
- Xem trang tham chiếu: khác biệt về đơn vị, khung thời gian và độ phủ giải thích phần lớn các sai lệch so với nguồn khác. Danh mục endpoint →
- Tái hiện lệnh gọi trong Playground và sao chép ID yêu cầu từ đó. API Playground →
Chênh lệch dữ liệu
Số liệu của CoinBoss được tính từ dữ liệu do chính CoinBoss thu thập. Việc chúng khác với website của sàn hoặc một trang dữ liệu khác là điều bình thường, do thời điểm ghi nhận, tập hợp sàn và loại hợp đồng được tính, vị thế mở một chiều hay hai chiều, đơn vị và ranh giới khung thời gian. Báo cáo nêu rõ năm điểm này sẽ được xử lý nhanh nhất.
Đề xuất dữ liệu hoặc endpoint
Còn thiếu một sàn, một trường hay một endpoint? Hãy gửi đề xuất qua trang liên hệ, kèm endpoint công khai của sàn mà từ đó có thể thu thập dữ liệu. Dữ liệu không có nguồn công khai hợp pháp vẫn được đánh dấu UNAVAILABLE.
Câu hỏi thường gặp
- API có miễn phí không?
- Có. Mọi endpoint dữ liệu đều công khai và miễn phí trong giai đoạn hiện tại, giới hạn ở 1200 yêu cầu mỗi phút.
- Tôi có cần khóa API không?
- Không. Khóa là tùy chọn và chỉ thay đổi cách tính yêu cầu của bạn khi áp dụng giới hạn tần suất.
- Vì sao một giá trị là null?
- Vì giá trị đó chưa biết: sàn không công bố, bản ghi đã quá hạn, hoặc dữ liệu không được thu thập. Khối coverage và trang chất lượng dữ liệu nêu rõ lý do.
- Tôi có thể dùng dữ liệu cho mục đích thương mại không?
- Xem điều khoản dịch vụ của trang này để biết các điều kiện sử dụng.
- Làm sao để biết khi có thay đổi?
- Nhật ký thay đổi liệt kê mọi thay đổi. Thay đổi trong phiên bản hiện tại chỉ mang tính bổ sung.