Arendajad
RefurbScore API
REST API ettevõtte andmete, passide, ülevaadete ja kaupmeeste integreerimiseks.
- Baas-URL
https://refurbscore.com
Autentimine
Kaupmehe lõpp-punktid nõuavad API-võtit (Pro-plaan). Edastage oma võti autoriseerimiskandja või X-API-Key päise kaudu.
Authorization: Bearer rs_live_…
# või
X-API-Key: rs_live_…Kerige külgsuunas, et lugeda kogu käsku.
Saadaolevad ulatused:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Skoori sõltumatus
The API exposes trust scores computed from verified data. Tasulised plaanid ja API-juurdepääs ei muuda kunagi skoori.
Hindade piirangud
- Avalikud lugemised
- 60req/min
- Autentitud
- 300req/min
- Tehte kirjutamine
- 30req/min
Vastused hõlmavad X-RateLimit-Remaining ja X-RateLimit-Reset päiseid.
Lõpp-punktid
Teed on esitatud baas-URL-i suhtes. Lõpp-punktid, mis on märgitud „Avalik“, ei nõua API-võtit ja neid piiratakse IP-aadressi kaupa.
- GET
/api/company/{slug}Aut: AvalikUlatus:read:company - GET
/api/company/{slug}/scoreAut: AvalikUlatus:read:company - GET
/api/company/{slug}/reviewsAut: AvalikUlatus:read:company - GET
/api/passport/{id}Aut: AvalikUlatus:read:passport - POST
/api/passportAut: API võtiUlatus:write:passport - POST
/api/reviewsAut: ValikulineUlatus:write:review - POST
/api/suggested-editAut: API võtiUlatus:write:edit - POST
/api/webhooksAut: API võtiUlatus:write:webhook
Näited
curl "https://refurbscore.com/api/company/nomophone"Kerige külgsuunas, et lugeda kogu käsku.
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"}'Kerige külgsuunas, et lugeda kogu käsku.
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"]}'Kerige külgsuunas, et lugeda kogu käsku.
Sündmused
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Turvalisus
- Kõik kirjutamistoimingud sisenevad enne avaldamist administraatori modereerimisrežiimi.
- API võtmed salvestatakse SHA-256 räsidena – töötlemata võtmeid kuvatakse loomisel üks kord.
- Veebihaagi tarned peaksid kontrollima X-Webhook-allkirja (HMAC-SHA256).
- Iga päring logitakse meetodi, tee, oleku, kestuse ja võtme prefiksiga.