Bilibili · Bình luận
Beta
Dữ liệu công khai từ các nền tảng mạng xã hội, tính phí theo lệnh gọi, dùng chung khóa API và số dư với các lệnh gọi mô hình.
Chỉ dành cho tài khoản đã nạp tiền lần đầu, không có dùng thử miễn phí · Chỉ tính phí khi lệnh gọi trả về HTTP 200 với data không rỗng; kết quả rỗng, tham số bị từ chối hoặc lỗi từ phía nguồn đều không tính phí.
Tham số yêu cầu
Tham số đặt trong query string theo đúng tên của nền tảng. Ví dụ lấy từ danh mục; hãy thay các định danh bằng nội dung bạn muốn lấy.
| Tên | Loại | Bắt buộc | Ví dụ | Mô tả |
|---|---|---|---|---|
bv_id | string | Có | "BV1M1421t7hT" | Video id |
pn | integer | Không | 1 | Page number |
Ví dụ yêu cầu
curl --get "https://api.chinaapi.ai/v1/social/bilibili/comments" \
-H "Authorization: Bearer $CHINAAPI_KEY" \
--data-urlencode 'bv_id=BV1M1421t7hT'Cấu trúc phản hồi
Phản hồi thành công bọc dữ liệu của nền tảng trong một lớp vỏ nhỏ. Mọi thứ bên trong data — tên trường, con trỏ phân trang, ID — đều là của nền tảng; hãy gửi lại con trỏ đúng như khi nhận được.
{
"object": "social.result",
"platform": "bilibili",
"capability": "comments",
"data": { … }
}Phân trang
Tham số phân trang: pn. Mỗi trang là một lệnh gọi tính phí riêng; hãy lấy giá trị con trỏ nguyên văn từ phản hồi trước.
Lỗi và các trường hợp không tính phí
| Mã trạng thái | Mã lỗi | Ý nghĩa |
|---|---|---|
| 400 | — | Một tham số không xác định, bị lặp, quá dài, sai kiểu hoặc bị thiếu, kể cả khi không có thành viên nào của nhóm "ít nhất một trong" được cung cấp. Trường code của lỗi cho biết là trường hợp nào, ví dụ unknown_parameter hoặc missing_parameter. |
| 403 | model_requires_topup | Tài khoản chưa hoàn tất lần nạp tiền đầu tiên. |
| 404 | social_data_no_result | Cặp nền tảng và chức năng không tồn tại, hoặc nền tảng không tìm thấy gì với các tham số này (social_data_no_result). |
| 429 | social_data_capacity_reached | Dung lượng trong ngày của bản beta đã hết và sẽ đặt lại lúc 00:00 UTC, hoặc nền tảng đang bận và thử lại sau vài giây là được. Đừng thử lại liên tục trong một vòng lặp sát nhau. |
| 502 | social_data_no_result | Nguồn dữ liệu không phản hồi, hoặc phản hồi mà không có dữ liệu. |
| 503 | social_data_unavailable | Endpoint này hiện đang tạm dừng; danh mục trực tiếp ghi nó là paused. |
Không phản hồi nào trong số này bị tính phí.
Mỗi phản hồi đều có header X-Oneapi-Request-Id; hãy gửi kèm khi liên hệ hỗ trợ để chúng tôi tìm đúng lệnh gọi đó.
Điều khoản bản beta
Hãy hoàn tất lần nạp tiền đầu tiên trước khi gọi. Tín dụng dùng thử không dùng được cho các endpoint này; tài khoản chưa từng nạp tiền sẽ nhận HTTP 403 model_requires_topup. Bản beta không có SLA, và các nền tảng, endpoint cũng như giá có thể thay đổi.
Tuân thủ điều khoản của từng nền tảng và các quy định bảo vệ dữ liệu áp dụng cho bạn. Không dùng API này để lập hồ sơ cá nhân. Đăng nhập, trích xuất thông tin liên hệ, thao túng lượt tương tác và truy cập nội dung riêng tư hoặc trả phí nằm ngoài phạm vi bản beta này.