Pengembang
API RefurbScore
REST API untuk data perusahaan, paspor, ulasan, dan integrasi pedagang.
- URL dasar
https://refurbscore.com
Autentikasi
Endpoint pedagang memerlukan kunci API (paket Pro). Berikan kunci Anda melalui header Authorization Bearer atau X-API-Key.
Authorization: Bearer rs_live_…
# atau
X-API-Key: rs_live_…Geser ke samping untuk membaca perintah selengkapnya.
Cakupan yang tersedia:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Independensi skor
API mengekspos skor kepercayaan yang dihitung dari data terverifikasi. Paket berbayar dan akses API tidak pernah mengubah skor.
Batas kecepatan
- Pembacaan publik
- 60permintaan/menit
- Terautentikasi
- 300permintaan/menit
- Operasi tulis
- 30permintaan/menit
Respons menyertakan header X-RateLimit-Remaining dan X-RateLimit-Reset.
Endpoint
Path bersifat relatif terhadap URL dasar. Endpoint “Publik” tidak memerlukan kunci API dan dibatasi lajunya per alamat IP.
- GET
/api/company/{slug}Autentikasi: PublikCakupan:read:company - GET
/api/company/{slug}/scoreAutentikasi: PublikCakupan:read:company - GET
/api/company/{slug}/reviewsAutentikasi: PublikCakupan:read:company - GET
/api/passport/{id}Autentikasi: PublikCakupan:read:passport - POST
/api/passportAutentikasi: Kunci APICakupan:write:passport - POST
/api/reviewsAutentikasi: OpsionalCakupan:write:review - POST
/api/suggested-editAutentikasi: Kunci APICakupan:write:edit - POST
/api/webhooksAutentikasi: Kunci APICakupan:write:webhook
Contoh
curl "https://refurbscore.com/api/company/nomophone"Geser ke samping untuk membaca perintah selengkapnya.
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"}'Geser ke samping untuk membaca perintah selengkapnya.
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"]}'Geser ke samping untuk membaca perintah selengkapnya.
Peristiwa
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Keamanan
- Semua operasi tulis masuk ke moderasi admin sebelum dipublikasikan.
- Kunci API disimpan sebagai hash SHA-256 — kunci mentah ditampilkan sekali saat pembuatan.
- Pengiriman webhook harus memverifikasi X-Webhook-Signature (HMAC-SHA256).
- Setiap permintaan dicatat dengan metode, jalur, status, durasi, dan awalan kunci.