นักพัฒนา
API RefurbScore
REST API สำหรับข้อมูลบริษัท พาสปอร์ต รีวิว และการผสานรวมผู้ขาย
- Base URL
https://refurbscore.com
การพิสูจน์ตัวตน
Endpoint ของผู้ขายต้องใช้คีย์ API (แผน Pro) ส่งคีย์ของคุณผ่านส่วนหัว 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
Endpoint
พาธเป็นพาธสัมพัทธ์จาก Base 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)
- คำขอทุกรายการถูกบันทึกด้วยวิธีการ เส้นทาง สถานะ ระยะเวลา และคำนำหน้าคีย์