Utviklere
RefurbScore API
REST-API for selskapsdata, pass, anmeldelser og selgerintegrasjoner.
- Basis-URL
https://refurbscore.com
Autentisering
forhandlerndpunkter krever en API-nøkkel (Pro-plan). tilstanda din nøkkel via Authorization Bearer eller X-API-Key-header.
Authorization: Bearer rs_live_…
# eller
X-API-Key: rs_live_…Rull sideveis for å lese hele kommandoen.
tilgjengelige omfang:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
poengets oavhengig
API:et exponerar tillitpoeng beregnete fra verifiserte data. Betalte planer och API-tilgang påvirker aldri poengen.
Hastighetsbegrensninger
- Offentlige lesningenr
- 60req/min
- Autentisert
- 300req/min
- skriveoperasjoner
- 30req/min
svar inkluderer X-RateLimit-Remaining och X-RateLimit-Reset-headeren.
Endpoints
Banene er relative til basis-URL-en. Endpoints merket «Offentlig» krever ingen API-nøkkel og er hastighetsbegrenset per IP-adresse.
- GET
/api/company/{slug}Autentisering: Offentligomfang:read:company - GET
/api/company/{slug}/scoreAutentisering: Offentligomfang:read:company - GET
/api/company/{slug}/reviewsAutentisering: Offentligomfang:read:company - GET
/api/passport/{id}Autentisering: Offentligomfang:read:passport - POST
/api/passportAutentisering: API-nøkkelomfang:write:passport - POST
/api/reviewsAutentisering: Valgfriomfang:write:review - POST
/api/suggested-editAutentisering: API-nøkkelomfang:write:edit - POST
/api/webhooksAutentisering: API-nøkkelomfang:write:webhook
Eksempler
curl "https://refurbscore.com/api/company/nomophone"Rull sideveis for å lese 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"}'Rull sideveis for å lese 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"]}'Rull sideveis for å lese hele kommandoen.
Hendelser
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Sikkerhet
- Alle skriveoperasjoner gjennomgår adminmoderering før publicering.
- API-nycklar lagres som SHA-256-hasher — rå nycklar viss en gang vid opprettelsen.
- Webhook-leveringer bør verifiser X-Webhook-segnature (HMAC-SHA256).
- Hver forespørsel loggføres med metode, bane, status, varighet og nøkkelprefiks.