Utvecklare
RefurbScore API
REST-API för företagsdata, pass, recensioner och handlarintegreringar.
- Bas-URL
https://refurbscore.com
Autentisering
Handlarendpunkter kräver en API-nyckel (Pro-plan). Skicka din nyckel via Authorization Bearer eller X-API-Key-huvud.
Authorization: Bearer rs_live_…
# eller
X-API-Key: rs_live_…Scrolla i sidled för att läsa hela kommandot.
Tillgängliga omfång:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Betygets oberoende
API:et exponerar förtroendebetyg beräknade från verifierade data. Betalda planer och API-åtkomst påverkar aldrig betygen.
Hastighetsbegränsningar
- Offentliga läsningar
- 60beg/min
- Autentiserad
- 300beg/min
- Skrivoperationer
- 30beg/min
Svar inkluderar X-RateLimit-Remaining och X-RateLimit-Reset-huvuden.
Endpoints
Sökvägarna är relativa till bas-URL:en. Endpoints märkta ”Offentlig” kräver ingen API-nyckel och är hastighetsbegränsade per IP-adress.
- 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"Scrolla i sidled för att läsa hela kommandot.
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"}'Scrolla i sidled för att läsa hela kommandot.
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"]}'Scrolla i sidled för att läsa hela kommandot.
Händelser
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Säkerhet
- Alla skrivoperationer genomgår adminmoderering innan publicering.
- API-nycklar lagras som SHA-256-hashar — råa nycklar visas en gång vid skapandet.
- Webhook-leveranser bör verifiera X-Webhook-Signature (HMAC-SHA256).
- Varje begäran loggas med metod, sökväg, status, varaktighet och nyckelprefix.