Pembangun
API RefurbScore
REST API untuk data syarikat, pasport, ulasan dan integrasi peniaga.
- URL asas
https://refurbscore.com
Pengesahan
Titik akhir peniaga memerlukan kunci API (pelan Pro). Hantar kunci anda melalui pengepala Authorization Bearer atau X-API-Key.
Authorization: Bearer rs_live_…
# atau
X-API-Key: rs_live_…Tatal ke sisi untuk membaca arahan penuh.
Skop yang tersedia:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Kebebasan skor
API mendedahkan skor kepercayaan yang dikira daripada data yang disahkan. Pelan berbayar dan akses API tidak pernah mengubah suai skor.
Had kadar
- Bacaan awam
- 60permintaan/minit
- Disahkan
- 300permintaan/minit
- Operasi tulis
- 30permintaan/minit
Respons menyertakan pengepala X-RateLimit-Remaining dan X-RateLimit-Reset.
Titik akhir
Laluan adalah relatif kepada URL asas. Endpoint “Awam” tidak memerlukan kunci API dan dihadkan kadarnya bagi setiap alamat IP.
- GET
/api/company/{slug}Auth: AwamSkop:read:company - GET
/api/company/{slug}/scoreAuth: AwamSkop:read:company - GET
/api/company/{slug}/reviewsAuth: AwamSkop:read:company - GET
/api/passport/{id}Auth: AwamSkop:read:passport - POST
/api/passportAuth: Kunci APISkop:write:passport - POST
/api/reviewsAuth: PilihanSkop:write:review - POST
/api/suggested-editAuth: Kunci APISkop:write:edit - POST
/api/webhooksAuth: Kunci APISkop:write:webhook
Contoh
curl "https://refurbscore.com/api/company/nomophone"Tatal ke sisi untuk membaca arahan penuh.
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"}'Tatal ke sisi untuk membaca arahan penuh.
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"]}'Tatal ke sisi untuk membaca arahan penuh.
Acara
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Keselamatan
- Semua operasi tulis masuk ke moderasi pentadbir sebelum penerbitan.
- Kunci API disimpan sebagai cincangan SHA-256 — kunci mentah ditunjukkan sekali semasa penciptaan.
- Penghantaran webhook perlu mengesahkan X-Webhook-Signature (HMAC-SHA256).
- Setiap permintaan dilog dengan kaedah, laluan, status, tempoh dan awalan kunci.