Udviklere
RefurbScore API
REST API til virksomhedsdata, pas, anmeldelser og sælgerintegrationer.
- Basis-URL
https://refurbscore.com
Autentisering
Endpoints til sælgere kræver en API-nøgle (planen Pro). Send din nøgle via headeren Authorization Bearer eller X-API-Key.
Authorization: Bearer rs_live_…
# eller
X-API-Key: rs_live_…Rul sidelæns for at læse hele kommandoen.
Tilgængelige scopes:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Scorens uafhængighed
API’et leverer tillidsscorer, der er beregnet ud fra verificerede data. Betalte planer og API-adgang ændrer aldrig scorerne.
Hastighedsbegrænsninger
- Offentlige læsninger
- 60beg/min
- Autentiserad
- 300beg/min
- Skrivoperationer
- 30beg/min
Svar inkluderar X-RateLimit-Remaining og X-RateLimit-Reset-huvuden.
Endpoints
Stierne er angivet i forhold til basis-URL. Endpoints markeret »Offentlig« kræver ingen API-nøgle og er hastighedsbegrænset pr. IP-adresse.
- GET
/api/company/{slug}Autentisering: OffentligOmfång:read:company - GET
/api/company/{slug}/scoreAutentisering: OffentligOmfång:read:company - GET
/api/company/{slug}/reviewsAutentisering: OffentligOmfång:read:company - GET
/api/passport/{id}Autentisering: OffentligOmfång:read:passport - POST
/api/passportAutentisering: API-nyckelOmfång:write:passport - POST
/api/reviewsAutentisering: ValfriOmfång:write:review - POST
/api/suggested-editAutentisering: API-nyckelOmfång:write:edit - POST
/api/webhooksAutentisering: API-nyckelOmfång:write:webhook
Exempel
curl "https://refurbscore.com/api/company/nomophone"Rul sidelæns for at læse hele kommandoen.
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"}'Rul sidelæns for at læse hele kommandoen.
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"]}'Rul sidelæns for at læse hele kommandoen.
Hændelser
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Sikkerhed
- Alla skrivoperationer genomgår adminmoderering innan publicering.
- API-nøgler lagras som SHA-256-hashar — råa nycklar visas en gång vid skapandet.
- Webhook-leverancer bør verificeres med X-Webhook-Signature (HMAC-SHA256).
- Hver anmodning logges med metode, sti, status, varighed og nøglepræfiks.