开发者
RefurbScore API
用于公司数据、护照、评价和商家集成的 REST API。
- 基础 URL
https://refurbscore.com
身份验证
商家端点需要 API 密钥（专业版计划）。通过 Authorization Bearer 或 X-API-Key 请求头传入您的密钥。
Authorization: Bearer rs_live_…
# 或
X-API-Key: rs_live_…向左右滚动即可查看完整命令。
可用范围：
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
评分独立性
API 公开从已验证数据计算的信任评分。付费计划和 API 访问绝不修改评分。
速率限制
- 公开读取
- 60次/分钟
- 已认证
- 300次/分钟
- 写入操作
- 30次/分钟
响应包含 X-RateLimit-Remaining 和 X-RateLimit-Reset 请求头。
端点
路径相对于基础 URL。“公开”端点无需 API 密钥，并按 IP 地址限制请求频率。
- GET
/api/company/{slug}认证: 公开范围:read:company - GET
/api/company/{slug}/score认证: 公开范围:read:company - GET
/api/company/{slug}/reviews认证: 公开范围:read:company - GET
/api/passport/{id}认证: 公开范围:read:passport - POST
/api/passport认证: API 密钥范围:write:passport - POST
/api/reviews认证: 可选范围:write:review - POST
/api/suggested-edit认证: API 密钥范围:write:edit - POST
/api/webhooks认证: API 密钥范围:write:webhook
示例
curl "https://refurbscore.com/api/company/nomophone"向左右滚动即可查看完整命令。
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"}'向左右滚动即可查看完整命令。
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"]}'向左右滚动即可查看完整命令。
事件
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
安全
- 所有写入操作在发布前进入管理员审核。
- API 密钥以 SHA-256 哈希存储——原始密钥仅在创建时显示一次。
- Webhook 推送应验证 X-Webhook-Signature（HMAC-SHA256）。
- 每个请求都记录方法、路径、状态、耗时和密钥前缀。