Nhà phát triển
API RefurbScore
REST API cho dữ liệu công ty, hộ chiếu, đánh giá và tích hợp người bán.
- URL gốc
https://refurbscore.com
Xác thực
Các endpoint của người bán yêu cầu khóa API (gói Pro). Truyền khóa của bạn qua tiêu đề Authorization Bearer hoặc X-API-Key.
Authorization: Bearer rs_live_…
# hoặc
X-API-Key: rs_live_…Cuộn ngang để đọc toàn bộ lệnh.
Phạm vi có sẵn:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Tính độc lập của điểm
API hiển thị điểm tin cậy được tính từ dữ liệu đã xác minh. Các gói trả tiền và quyền truy cập API không bao giờ sửa đổi điểm.
Giới hạn tốc độ
- Đọc công khai
- 60yêu cầu/phút
- Đã xác thực
- 300yêu cầu/phút
- Thao tác ghi
- 30yêu cầu/phút
Các phản hồi bao gồm tiêu đề X-RateLimit-Remaining và X-RateLimit-Reset.
Endpoint
Các đường dẫn là tương đối so với URL gốc. Các endpoint “Công khai” không cần khóa API và bị giới hạn tốc độ theo từng địa chỉ IP.
- GET
/api/company/{slug}Xác thực: Công khaiPhạm vi:read:company - GET
/api/company/{slug}/scoreXác thực: Công khaiPhạm vi:read:company - GET
/api/company/{slug}/reviewsXác thực: Công khaiPhạm vi:read:company - GET
/api/passport/{id}Xác thực: Công khaiPhạm vi:read:passport - POST
/api/passportXác thực: Khóa APIPhạm vi:write:passport - POST
/api/reviewsXác thực: Tùy chọnPhạm vi:write:review - POST
/api/suggested-editXác thực: Khóa APIPhạm vi:write:edit - POST
/api/webhooksXác thực: Khóa APIPhạm vi:write:webhook
Ví dụ
curl "https://refurbscore.com/api/company/nomophone"Cuộn ngang để đọc toàn bộ lệnh.
curl -X POST "https://refurbscore.com/api/passport" \
-H "Authorization: Bearer rs_live_…" \
-H "Content-Type: application/json" \
-d '{"brand":"Apple","model":"iPhone 13","condition":"A","summary":"128GB"}'Cuộn ngang để đọc toàn bộ lệnh.
curl -X POST "https://refurbscore.com/api/webhooks" \
-H "Authorization: Bearer rs_live_…" \
-H "Content-Type: application/json" \
-d '{"action":"register","url":"https://example.com/hook","events":["review.published"]}'Cuộn ngang để đọc toàn bộ lệnh.
Sự kiện
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Bảo mật
- Tất cả thao tác ghi đều vào kiểm duyệt quản trị viên trước khi xuất bản.
- Khóa API được lưu trữ dưới dạng hash SHA-256 — khóa thô được hiển thị một lần khi tạo.
- Các lần gửi webhook nên xác minh X-Webhook-Signature (HMAC-SHA256).
- Mọi yêu cầu đều được ghi lại với phương thức, đường dẫn, trạng thái, thời lượng và tiền tố khóa.