GETKhả dụng
Kiểm tra liveness
Kiểm tra liveness
GET
/api/healthYêu cầu
Endpoint này không nhận tham số nào.
Yêu cầu mẫu
curl -s "https://www.coinboss.com/api/health"Trường phản hồi
Bảng trường được tạo từ phản hồi thật nên liệt kê đúng những gì endpoint trả về. Đường dẫn dùng a[] cho phần tử mảng và {*} cho object có khóa là tên động, chẳng hạn một coin hoặc một sàn.
| Trường | Kiểu | Đơn vị | Mô tả |
|---|---|---|---|
| status | string | — | Trạng thái. |
| time | number | ms | Dấu thời gian. |
Tạo lúc 2026-11-11 23:01 UTC từ 1 phản hồi thật.
Phản hồi mẫu
/api/health · Phản hồi thật, ghi lại lúc 2026-11-13 03:53:48 UTC.
- "status""ok"
- "time"1794542028933
Chi tiết
- Xác thực
- Không cần. Endpoint công khai.
- Giới hạn tần suất
- 1200 yêu cầu mỗi phút cho mỗi IP
- Cache máy chủ
- Không cache
- Tần suất cập nhật
- thời gian thực, không cache
- Nguồn dữ liệu
- Kiểm tra máy chủ còn hoạt động; chỉ trả về thời gian máy chủ, không có nguồn dữ liệu.
- Phân trang
- không có
- Dấu thời gian
- Unix epoch tính bằng mili giây (UTC), trừ khi mô tả trường ghi khác
- Định dạng phản hồi
- json
- Độ ổn định
- Ổn định
Trạng thái trực tiếp
Khả dụngKiểm tra lúc 2026-11-13 03:53:48 UTCHTTP 2001 msSchema khớp
Độ khả dụng, 30 ngày qua
100% trong 407 lần kiểm tra đạt
Lỗi
Lệnh gọi thất bại có chung một cấu trúc trên mọi endpoint. Danh sách đầy đủ nằm ở trang lỗi. Lỗi và giới hạn tần suất →
| Mã | HTTP | Ý nghĩa | Cách xử lý |
|---|---|---|---|
| INVALID_PARAM | 400 | Thiếu một tham số bắt buộc hoặc một giá trị không được chấp nhận. `param` nêu tên tham số khi xác định được. | Đừng thử lại với yêu cầu y nguyên; hãy sửa yêu cầu. |
| UNAUTHORIZED | 401 | Header `CB-API-KEY` đã được gửi nhưng khóa không tồn tại hoặc đã bị thu hồi. Dữ liệu công khai không cần khóa — hãy bỏ header hoặc dùng một khóa hợp lệ. | Đừng thử lại với yêu cầu y nguyên. |
| FORBIDDEN | 403 | Route này không thuộc API công khai (nội bộ hoặc chỉ dành cho tài khoản). | Đừng thử lại. |
| NOT_FOUND | 404 | Route không xác định, hoặc coin / sàn / quỹ được yêu cầu không tồn tại. | Đừng thử lại; hãy đối chiếu đường dẫn và các mã định danh với danh mục. |
| RATE_LIMITED | 429 | Số yêu cầu vượt quá giới hạn mỗi phút. `Retry-After` cho biết số giây cần chờ. | Chờ theo `Retry-After`, rồi thử lại có backoff. |
| INTERNAL | 500 | Lỗi máy chủ không mong đợi. Thông báo được cố ý viết chung chung; hãy trích dẫn `request_id` khi báo lỗi. | Thử lại một lần sau vài giây; nếu lỗi vẫn tiếp diễn, hãy báo cáo kèm ID yêu cầu. |
| UPSTREAM_FAILED | 503 | Nguồn dữ liệu đứng sau endpoint này không trả lời kịp thời. Không có số liệu quá hạn hay số liệu thay thế nào được trả về thay cho nó. | Thử lại có backoff; xem trang trạng thái. |
| UNAVAILABLE | 501 / 503 | Bộ dữ liệu tạm thời chưa sẵn sàng (cache đang được làm nóng) hoặc endpoint chưa có nguồn công khai hợp pháp. | Thử lại sau; danh mục có đánh dấu những endpoint không khả dụng theo thiết kế. |
| REQUEST_FAILED | 200 | Một số endpoint cũ hơn trả về HTTP 200 với `success: false`. Hãy luôn kiểm tra `success`, không chỉ trạng thái HTTP. | Tùy vào thông báo; hãy coi là một yêu cầu thất bại. |
Dùng thử
GET
/api/healthKhả dụngTham số
Không có tham số.
URL yêu cầu
https://www.coinboss.com/api/healthChọn một endpoint rồi nhấn “Gửi yêu cầu”. Phản hồi, header và thời gian xử lý sẽ hiện ở đây.
Endpoint khác trong danh mục này
- Ma trận chất lượng dữ liệu (góc nhìn trình thu thập) /api/sd/quality
- Danh mục API /api/meta/catalog
- Nhật ký thay đổi và chính sách phiên bản /api/meta/changelog
- Tài liệu endpoint /api/meta/endpoint
- Tài liệu OpenAPI /api/meta/openapi
- Ma trận chất lượng dữ liệu /api/meta/quality
- Trạng thái dịch vụ /api/meta/status
- Kiểm tra một ký hiệu coin có được nền tảng nhận biết hay không /api/coin-exists
- Bảng ánh xạ từ ký hiệu coin sang đường dẫn icon lưu cục bộ /api/coin-icons
- Tóm tắt tổng hợp của trang coin /api/content/coin
- Tóm tắt các chuyên mục toàn trang /api/content/summary
- Bảng tỷ giá tiền pháp định /api/currency/fx
- Bảng ánh xạ từ id sàn sang đường dẫn icon lưu cục bộ /api/exchange-icons
- Kiểm tra liveness /api/health
- Thống kê trang nghiên cứu /api/research/stats