Sviluppatori
API RefurbScore
API REST per dati aziendali, passaporti, recensioni e integrazioni per venditori.
- URL di base
https://refurbscore.com
Autenticazione
Gli endpoint del venditore richiedono una chiave API (piano Pro). Passa la tua chiave tramite l'intestazione Authorization Bearer o X-API-Key.
Authorization: Bearer rs_live_…
# oppure
X-API-Key: rs_live_…Scorri lateralmente per leggere il comando completo.
Ambiti disponibili:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Indipendenza del punteggio
L'API espone punteggi di fiducia calcolati da dati verificati. I piani a pagamento e l'accesso API non modificano mai i punteggi.
Limiti di frequenza
- Letture pubbliche
- 60req/min
- Autenticato
- 300req/min
- Operazioni di scrittura
- 30req/min
Le risposte includono le intestazioni X-RateLimit-Remaining e X-RateLimit-Reset.
Endpoint
I percorsi sono relativi all’URL di base. Gli endpoint «Pubblici» non richiedono una chiave API e hanno un limite di richieste per indirizzo IP.
- GET
/api/company/{slug}Autenticazione: PubblicoAmbito:read:company - GET
/api/company/{slug}/scoreAutenticazione: PubblicoAmbito:read:company - GET
/api/company/{slug}/reviewsAutenticazione: PubblicoAmbito:read:company - GET
/api/passport/{id}Autenticazione: PubblicoAmbito:read:passport - POST
/api/passportAutenticazione: Chiave APIAmbito:write:passport - POST
/api/reviewsAutenticazione: OpzionaleAmbito:write:review - POST
/api/suggested-editAutenticazione: Chiave APIAmbito:write:edit - POST
/api/webhooksAutenticazione: Chiave APIAmbito:write:webhook
Esempi
curl "https://refurbscore.com/api/company/nomophone"Scorri lateralmente per leggere il comando completo.
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"}'Scorri lateralmente per leggere il comando completo.
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"]}'Scorri lateralmente per leggere il comando completo.
Eventi
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Sicurezza
- Tutte le operazioni di scrittura entrano nella moderazione admin prima della pubblicazione.
- Le chiavi API sono memorizzate come hash SHA-256 — le chiavi grezze vengono mostrate una sola volta alla creazione.
- Le consegne webhook devono verificare X-Webhook-Signature (HMAC-SHA256).
- Ogni richiesta viene registrata con metodo, percorso, stato, durata e prefisso della chiave.