Zhvilluesit
API RefurbRezultati
REST API dlya danih kompanij, pasportiv, vidgukiv ta integracij prodavciv.
- URL bazë
https://refurbscore.com
Avtentifikaciya
Kincevi tochki prodavcya vimagayut API-klyucha (tarifnij plan Pro). Peredajte klyuch cherez Authorization Bearer abo zagolovok X-API-Key.
Authorization: Bearer rs_live_…
# ose
X-API-Key: rs_live_…Lëvizni anash për të lexuar komandën e plotë.
Dostupni obsyagi:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Nezalezhnist ocinki
API ofron rezultate besimi të llogaritura nga të dhëna të verifikuara. Planet me pagesë dhe qasja në API nuk i ndryshojnë kurrë rezultatet.
Obmezhennya zapitiv
- Publikhni zapiti
- 60zapit/hv
- Avtentifikovani
- 300zapit/hv
- Operacii zapisu
- 30zapit/hv
Vidpovidi vklyuchayut zagolovki X-RateLimit-Remaining i X-RateLimit-Reset.
Kincevi tochki
Rrugët janë relative me URL-në bazë. Endpoint-et «Publike» nuk kërkojnë çelës API dhe kanë kufizim kërkesash për adresë IP.
- GET
/api/company/{slug}Avtentifikaciya: PublikhnijObsyag:read:company - GET
/api/company/{slug}/scoreAvtentifikaciya: PublikhnijObsyag:read:company - GET
/api/company/{slug}/reviewsAvtentifikaciya: PublikhnijObsyag:read:company - GET
/api/passport/{id}Avtentifikaciya: PublikhnijObsyag:read:passport - POST
/api/passportAvtentifikaciya: API-klyuchObsyag:write:passport - POST
/api/reviewsAvtentifikaciya: Neobov'yazkovoObsyag:write:review - POST
/api/suggested-editAvtentifikaciya: API-klyuchObsyag:write:edit - POST
/api/webhooksAvtentifikaciya: API-klyuchObsyag:write:webhook
Prikladi
curl "https://refurbscore.com/api/company/nomophone"Lëvizni anash për të lexuar komandën e plotë.
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"}'Lëvizni anash për të lexuar komandën e plotë.
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"]}'Lëvizni anash për të lexuar komandën e plotë.
Podii
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Bezpeka
- Usi operacii zapisu prohodyat moderaciyu adminom pered publikacieyu.
- API-klyuchi zberigayutsya u viglyadi heshiv SHA-256 — neobrobleni klyuchi vidobrazhayutsya odin raz pri stvorenni.
- Dostavki webhook povinni pereviryati X-Webhook-Signature (HMAC-SHA256).
- Kozhen zapit reestruetsya z metodom, shlyahom, statusom, trivalistyu ta prefiksom klyucha.