Vývojári
API RefurbScore
REST API pre danych firm, pasów, recenzií i integracji handlowych.
- Základná URL
https://refurbscore.com
Autentifikácia
Endpointy pre predajcov vyžadujú kľúč API (plán Pro). Kľúč odovzdajte v hlavičke Authorization Bearer alebo X-API-Key.
Authorization: Bearer rs_live_…
# alebo
X-API-Key: rs_live_…Posunutím do strany zobrazíte celý príkaz.
Dostupné rozsahy:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Nezávislosť skóre
API poskytuje skóre dôvery vypočítané z overených údajov. Platené plány ani prístup k API skóre nikdy neovplyvňujú.
Limity požiadaviek
- Verejné odczyty
- 60pož./min
- Overené
- 300pož./min
- Zápisové operácie
- 30pož./min
Odpovede obsahujú hlavičky X-RateLimit-Remaining a X-RateLimit-Reset.
Koncové body
Cesty sú relatívne k základnej URL. Endpointy označené „Verejné“ nevyžadujú kľúč API a majú obmedzený počet požiadaviek na IP adresu.
- GET
/api/company/{slug}Overenie: VerejnéZakres:read:company - GET
/api/company/{slug}/scoreOverenie: VerejnéZakres:read:company - GET
/api/company/{slug}/reviewsOverenie: VerejnéZakres:read:company - GET
/api/passport/{id}Overenie: VerejnéZakres:read:passport - POST
/api/passportOverenie: Kľúč APIZakres:write:passport - POST
/api/reviewsOverenie: VoliteľnéZakres:write:review - POST
/api/suggested-editOverenie: Kľúč APIZakres:write:edit - POST
/api/webhooksOverenie: Kľúč APIZakres:write:webhook
Príklady
curl "https://refurbscore.com/api/company/nomophone"Posunutím do strany zobrazíte celý príkaz.
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"}'Posunutím do strany zobrazíte celý príkaz.
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"]}'Posunutím do strany zobrazíte celý príkaz.
Udalosti
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Bezpečnosť
- Všetky zápisové operácie pred zverejnením prechádzajú administrátorskou moderáciou.
- Kľúče API sa ukladajú ako hashe SHA-256 — nespracovaný kľúč sa zobrazí iba raz, pri vytvorení.
- Dostarczenia webhooków powinny weryfikować X-Webhook-Signature (HMAC-SHA256).
- Každá požiadavka sa zaznamenáva s metódou, cestou, stavom, trvaním a prefixom kľúča.