Kūrėjams
RefurbScore API
REST API įmonių duomenims, pasams, atsiliepimams ir pardavėjų integracijoms.
- Bazinis URL
https://refurbscore.com
Autentifikacija
Pardavėjų galiniai taškai reikalauja API rakto (Pro planas). Perduokite savo raktą per Authorization Bearer arba X-API-Key antraštę.
Authorization: Bearer rs_live_…
# arba
X-API-Key: rs_live_…Slinkite į šoną, kad perskaitytumėte visą komandą.
Galimos aprėptys:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Įvertinimų nepriklausomybė
API atskleidžia pasitikėjimo įvertinimus, apskaičiuotus iš patvirtintų duomenų. Mokamieji planai ir API prieiga niekada nekeičia įvertinimų.
Greičio apribojimai
- Viešieji skaitymai
- 60uzkl/min
- Autentifikuota
- 300uzkl/min
- Rašymo operacijos
- 30uzkl/min
Atsakymai apima X-RateLimit-Remaining ir X-RateLimit-Reset antraštes.
Galiniai taškai
Keliai nurodyti bazinio URL atžvilgiu. Taškams su žyma „Viešas“ API raktas nereikalingas, o užklausų skaičius ribojamas pagal IP adresą.
- GET
/api/company/{slug}Autentifikacija: ViešasAprėptis:read:company - GET
/api/company/{slug}/scoreAutentifikacija: ViešasAprėptis:read:company - GET
/api/company/{slug}/reviewsAutentifikacija: ViešasAprėptis:read:company - GET
/api/passport/{id}Autentifikacija: ViešasAprėptis:read:passport - POST
/api/passportAutentifikacija: API raktasAprėptis:write:passport - POST
/api/reviewsAutentifikacija: NeprivalomasAprėptis:write:review - POST
/api/suggested-editAutentifikacija: API raktasAprėptis:write:edit - POST
/api/webhooksAutentifikacija: API raktasAprėptis:write:webhook
Pavyzdžiai
curl "https://refurbscore.com/api/company/nomophone"Slinkite į šoną, kad perskaitytumėte visą komandą.
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"}'Slinkite į šoną, kad perskaitytumėte visą komandą.
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"]}'Slinkite į šoną, kad perskaitytumėte visą komandą.
Įvykiai
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Saugumas
- Visos rašymo operacijos patenka į administratoriaus moderavimą prieš paskelbimą.
- API raktai saugomi kaip SHA-256 maišos — neapdoroti raktai rodomi vieną kartą kuriant.
- Tinklo kabliuko pristatymai turėtų patikrinti X-Webhook-Signature (HMAC-SHA256).
- Kiekviena užklausa registruojama su metodu, keliu, būsena, trukme ir rakto prefiksu.