Izstrādātāji
RefurbScore API
REST API uzņēmumu datiem, pasēm, atsauksmēm un tirgotāju integrācijām.
- Bāzes URL
https://refurbscore.com
Autentifikācija
Tirgotāja galapunktiem nepieciešama API atslēga (Pro plāns). Nododiet atslēgu ar Authorization Bearer vai X-API-Key galveni.
Authorization: Bearer rs_live_…
# vai
X-API-Key: rs_live_…Ritiniet horizontāli, lai izlasītu visu komandu.
Pieejamās tvērumu jomas:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Vērtējumu neatkarība
API atklāj uzticamības vērtējumus, kas aprēķināti no verificētiem datiem. Maksas plāni un API piekļuve nekad nemaina vērtējumus.
Ātruma ierobežojumi
- Publiskās lasīšanas
- 60piepras/min
- Autentificēts
- 300piepras/min
- Rakstīšanas operācijas
- 30piepras/min
Atbildes ietver X-RateLimit-Remaining un X-RateLimit-Reset galvenes.
Galapunkti
Ceļi ir norādīti attiecībā pret bāzes URL. Galapunkti ar atzīmi „Publisks“ neprasa API atslēgu, un tiem ir ātruma ierobežojums katrai IP adresei.
- GET
/api/company/{slug}Autentifikācija: PublisksTvērums:read:company - GET
/api/company/{slug}/scoreAutentifikācija: PublisksTvērums:read:company - GET
/api/company/{slug}/reviewsAutentifikācija: PublisksTvērums:read:company - GET
/api/passport/{id}Autentifikācija: PublisksTvērums:read:passport - POST
/api/passportAutentifikācija: API atslēgaTvērums:write:passport - POST
/api/reviewsAutentifikācija: NeobligātsTvērums:write:review - POST
/api/suggested-editAutentifikācija: API atslēgaTvērums:write:edit - POST
/api/webhooksAutentifikācija: API atslēgaTvērums:write:webhook
Piemēri
curl "https://refurbscore.com/api/company/nomophone"Ritiniet horizontāli, lai izlasītu visu komandu.
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"}'Ritiniet horizontāli, lai izlasītu visu komandu.
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"]}'Ritiniet horizontāli, lai izlasītu visu komandu.
Notikumi
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Drošība
- Visas rakstīšanas operācijas nonāk administratora moderēšanā pirms publicēšanas.
- API atslēgas tiek glabātas kā SHA-256 jaucēji — neapstrādātas atslēgas tiek rādītas vienu reizi izveides brīdī.
- Tīmekļa āķa piegādēm vajadzētu verificēt X-Webhook-Signature (HMAC-SHA256).
- Katrs pieprasījums tiek reģistrēts ar metodi, ceļu, statusu, ilgumu un atslēgas prefiksu.