開發者
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）。
- 每個請求都記錄方法、路徑、狀態、耗時和金鑰前綴。