Dezvoltatori
API de RefurbScore
API REST pentru date companii, pașapoarte, recenzii și integrări comercianți.
- URL de bază
https://refurbscore.com
Autentificare
Endpoint-urile comercianților necesită o cheie API (plan Pro). Trimite cheia prin header Authorization Bearer sau X-API-Key.
Authorization: Bearer rs_live_…
# sau
X-API-Key: rs_live_…Derulează lateral pentru a citi comanda completă.
Domenii disponibile:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Independența scorului
API-ul expune scoruri de încredere calculate din date verificate. Planurile plătite și accesul API nu modifică niciodată scorurile.
Limite de rată
- Citiri publice
- 60req/min
- Autentificat
- 300req/min
- Operațiuni de scriere
- 30req/min
Răspunsurile includ headerele X-RateLimit-Remaining și X-RateLimit-Reset.
Endpoint-uri
Căile sunt relative la URL-ul de bază. Endpoint-urile „Publice” nu necesită cheie API și au o limită de cereri per adresă IP.
- GET
/api/company/{slug}Autentificare: PublicDomeniu:read:company - GET
/api/company/{slug}/scoreAutentificare: PublicDomeniu:read:company - GET
/api/company/{slug}/reviewsAutentificare: PublicDomeniu:read:company - GET
/api/passport/{id}Autentificare: PublicDomeniu:read:passport - POST
/api/passportAutentificare: Cheie APIDomeniu:write:passport - POST
/api/reviewsAutentificare: OpționalDomeniu:write:review - POST
/api/suggested-editAutentificare: Cheie APIDomeniu:write:edit - POST
/api/webhooksAutentificare: Cheie APIDomeniu:write:webhook
Exemple
curl "https://refurbscore.com/api/company/nomophone"Derulează lateral pentru a citi comanda completă.
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"}'Derulează lateral pentru a citi comanda completă.
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"]}'Derulează lateral pentru a citi comanda completă.
Evenimente
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Securitate
- Toate operațiile de scriere intră în moderare admin înainte de publicare.
- Cheile API sunt stocate ca hash SHA-256 — cheile brute sunt afișate o singură dată la creare.
- Livrările webhook trebuie să verifice X-Webhook-Signature (HMAC-SHA256).
- Fiecare cerere este înregistrată cu metodă, cale, status, durată și prefix cheie.