Fejlesztőknek
RefurbScore API
REST API cégadatokhoz, útlevelekhez, véleményekhez és kereskedői integrációkhoz.
- Alap-URL
https://refurbscore.com
Hitelesítés
A kereskedői végpontokhoz API-kulcs szükséges (Pro csomag). Add meg a kulcsot az Authorization Bearer vagy X-API-Key fejlécen keresztül.
Authorization: Bearer rs_live_…
# vagy
X-API-Key: rs_live_…Görgess oldalra a teljes parancs megtekintéséhez.
Elérhető hatókörök:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Pontszám-függetlenség
Az API ellenőrzött adatokból kiszámított bizalmi pontszámokat tesz elérhetővé. A fizetős csomagok és az API-hozzáférés soha nem módosítják a pontszámokat.
Sebességkorlátok
- Nyilvános olvasások
- 60kér/perc
- Hitelesített
- 300kér/perc
- Írási műveletek
- 30kér/perc
A válaszok tartalmazzák az X-RateLimit-Remaining és X-RateLimit-Reset fejléceket.
Végpontok
Az elérési utak az alap-URL-hez képest értendők. A „Nyilvános” végpontokhoz nem kell API-kulcs, és IP-címenként korlátozott a hívások száma.
- GET
/api/company/{slug}Hitelesítés: NyilvánosHatókör:read:company - GET
/api/company/{slug}/scoreHitelesítés: NyilvánosHatókör:read:company - GET
/api/company/{slug}/reviewsHitelesítés: NyilvánosHatókör:read:company - GET
/api/passport/{id}Hitelesítés: NyilvánosHatókör:read:passport - POST
/api/passportHitelesítés: API-kulcsHatókör:write:passport - POST
/api/reviewsHitelesítés: OpcionálisHatókör:write:review - POST
/api/suggested-editHitelesítés: API-kulcsHatókör:write:edit - POST
/api/webhooksHitelesítés: API-kulcsHatókör:write:webhook
Példák
curl "https://refurbscore.com/api/company/nomophone"Görgess oldalra a teljes parancs megtekintéséhez.
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"}'Görgess oldalra a teljes parancs megtekintéséhez.
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"]}'Görgess oldalra a teljes parancs megtekintéséhez.
Események
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Biztonság
- Minden írási művelet admin moderáláson megy keresztül közzététel előtt.
- Az API-kulcsokat SHA-256 kivonatként tárolják — a nyers kulcsok csak egyszer láthatók a létrehozáskor.
- A webhook-kézbesítéseknek ellenőrizniük kell az X-Webhook-Signature értékét (HMAC-SHA256).
- Minden kérés naplózásra kerül metódussal, útvonallal, állapottal, időtartammal és kulcs előtaggal.