Kehittäjät
RefurbScore API
REST API yritysdatalle, passeille, arvosteluille ja kauppias-integraatioille.
- Perus-URL
https://refurbscore.com
Todennus
Kauppiasrajapinnat vaativat API-avaimen (Pro-suunnitelma). Välitä avain Authorization Bearer- tai X-API-Key-otsikon kautta.
Authorization: Bearer rs_live_…
# tai
X-API-Key: rs_live_…Vieritä sivusuunnassa nähdäksesi koko komennon.
Käytettävissä olevat laajuudet:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Pisteiden riippumattomuus
API näyttää luottamuspisteet, jotka on laskettu varmennetusta datasta. Maksulliset suunnitelmat ja API-pääsy eivät koskaan muuta pisteitä.
Nopeusrajoitukset
- Julkiset lukemat
- 60pyyn/min
- Todennettu
- 300pyyn/min
- Kirjoitusoperaatiot
- 30pyyn/min
Vastauksissa on X-RateLimit-Remaining ja X-RateLimit-Reset -otsikot.
Rajapisteet
Polut ovat suhteellisia perus-URL-osoitteeseen. ”Julkinen”-merkityt rajapisteet eivät vaadi API-avainta, ja niiden käyttöä rajoitetaan IP-osoitekohtaisesti.
- GET
/api/company/{slug}Todennus: JulkinenLaajuus:read:company - GET
/api/company/{slug}/scoreTodennus: JulkinenLaajuus:read:company - GET
/api/company/{slug}/reviewsTodennus: JulkinenLaajuus:read:company - GET
/api/passport/{id}Todennus: JulkinenLaajuus:read:passport - POST
/api/passportTodennus: API-avainLaajuus:write:passport - POST
/api/reviewsTodennus: ValinnainenLaajuus:write:review - POST
/api/suggested-editTodennus: API-avainLaajuus:write:edit - POST
/api/webhooksTodennus: API-avainLaajuus:write:webhook
Esimerkit
curl "https://refurbscore.com/api/company/nomophone"Vieritä sivusuunnassa nähdäksesi koko komennon.
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"}'Vieritä sivusuunnassa nähdäksesi koko komennon.
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"]}'Vieritä sivusuunnassa nähdäksesi koko komennon.
Tapahtumat
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Turvallisuus
- Kaikki kirjoitusoperaatiot menevät ylläpidon moderointiin ennen julkaisua.
- API-avaimet tallennetaan SHA-256-hajautuksina — raakaavaimet näytetään kerran luomisen yhteydessä.
- Webhook-toimituksissa tulisi tarkistaa X-Webhook-Signature (HMAC-SHA256).
- Jokainen pyyntö kirjataan metodin, polun, tilan, keston ja avaimen etuliitteen kanssa.