Développeurs
API RefurbScore
API REST pour données société, passeports, avis et intégrations marchands.
- URL de base
https://refurbscore.com
Authentification
Les endpoints marchands requièrent une clé API (plan Pro). Passez la clé via Authorization Bearer ou l'en-tête X-API-Key.
Authorization: Bearer rs_live_…
# ou
X-API-Key: rs_live_…Faites défiler horizontalement pour lire la commande complète.
Scopes disponibles :
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Indépendance du score
L'API expose des scores calculés à partir de données vérifiées. Les plans payants et l'accès API ne modifient jamais les scores.
Limites de débit
- Lectures publiques
- 60req/min
- Authentifié
- 300req/min
- Écritures
- 30req/min
Les réponses incluent X-RateLimit-Remaining et X-RateLimit-Reset.
Endpoints
Les chemins sont relatifs à l'URL de base. Les endpoints « Public » ne nécessitent pas de clé API et sont limités par adresse IP.
- GET
/api/company/{slug}Authentification: PublicScope:read:company - GET
/api/company/{slug}/scoreAuthentification: PublicScope:read:company - GET
/api/company/{slug}/reviewsAuthentification: PublicScope:read:company - GET
/api/passport/{id}Authentification: PublicScope:read:passport - POST
/api/passportAuthentification: Clé APIScope:write:passport - POST
/api/reviewsAuthentification: OptionnelScope:write:review - POST
/api/suggested-editAuthentification: Clé APIScope:write:edit - POST
/api/webhooksAuthentification: Clé APIScope:write:webhook
Exemples
curl "https://refurbscore.com/api/company/nomophone"Faites défiler horizontalement pour lire la commande complète.
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"}'Faites défiler horizontalement pour lire la commande complète.
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"]}'Faites défiler horizontalement pour lire la commande complète.
Événements
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Sécurité
- Toute écriture passe par modération admin avant publication.
- Les clés API sont stockées en hash SHA-256 — la clé brute n'est affichée qu'une fois.
- Les webhooks entrants doivent vérifier X-Webhook-Signature (HMAC-SHA256).
- Chaque requête est journalisée (méthode, chemin, statut, durée, préfixe de clé).