Ontwikkelaars
RefurbScore API
REST API voor bedrijfsgegevens, paspoorten, beoordelingen en verkopersintegraties.
- Basis-URL
https://refurbscore.com
Authenticatie
Verkoperseindpunten vereisen een API-sleutel (Pro-abonnement). Geef uw sleutel door via Authorization Bearer of X-API-Key header.
Authorization: Bearer rs_live_…
# of
X-API-Key: rs_live_…Scroll opzij om het volledige commando te lezen.
Beschikbare scopes:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Score-onafhankelijkheid
De API geeft vertrouwensscores weer die worden berekend uit geverifieerde gegevens. Betaalde abonnementen en API-toegang wijzigen nooit scores.
Snelheidslimieten
- Openbare leesbewerkingen
- 60verz./min
- Geverifieerd
- 300verz./min
- Schrijfbewerkingen
- 30verz./min
Antwoorden bevatten X-RateLimit-Remaining en X-RateLimit-Reset headers.
Eindpunten
Paden zijn relatief ten opzichte van de basis-URL. “Openbare” eindpunten hebben geen API-sleutel nodig en zijn per IP-adres aan een limiet gebonden.
- GET
/api/company/{slug}Auth: OpenbaarScope:read:company - GET
/api/company/{slug}/scoreAuth: OpenbaarScope:read:company - GET
/api/company/{slug}/reviewsAuth: OpenbaarScope:read:company - GET
/api/passport/{id}Auth: OpenbaarScope:read:passport - POST
/api/passportAuth: API-sleutelScope:write:passport - POST
/api/reviewsAuth: OptioneelScope:write:review - POST
/api/suggested-editAuth: API-sleutelScope:write:edit - POST
/api/webhooksAuth: API-sleutelScope:write:webhook
Voorbeelden
curl "https://refurbscore.com/api/company/nomophone"Scroll opzij om het volledige commando te lezen.
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"}'Scroll opzij om het volledige commando te lezen.
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"]}'Scroll opzij om het volledige commando te lezen.
Gebeurtenissen
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Beveiliging
- Alle schrijfbewerkingen gaan door beheerdermatiging voor publicatie.
- API-sleutels worden opgeslagen als SHA-256-hashes — onbewerkte sleutels worden eenmalig getoond bij aanmaak.
- Webhookbezorgingen moeten X-Webhook-Signature (HMAC-SHA256) verifiëren.
- Elk verzoek wordt geregistreerd met methode, pad, status, duur en sleutelprefiks.