Programeri
API RefurbScore
REST API dla danych firm, paszportów, opinii i integracji handlowych.
- Osnovni URL
https://refurbscore.com
Uwierzytelnianie
Krajnje točke za trgovce zahtijevaju API ključ (plan Pro). Proslijedite ključ putem zaglavlja Authorization Bearer ili X-API-Key.
Authorization: Bearer rs_live_…
# ili
X-API-Key: rs_live_…Pomaknite u stranu za prikaz cijele naredbe.
Dostupni opsezi:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Neovisnost ocjene
API izlaže ocjene povjerenja izračunate iz verificiranih podataka. Plaćeni planovi i pristup API-ju nikada ne mijenjaju ocjene.
Ograničenja zahtjeva
- Publiczne odczyty
- 60zahtjeva/min
- Autentificirano
- 300zahtjeva/min
- Operacije pisanja
- 30zahtjeva/min
Odgovori sadrže zaglavlja X-RateLimit-Remaining i X-RateLimit-Reset.
Krajnje točke
Putanje su relativne u odnosu na osnovni URL. Krajnje točke označene kao „Javno“ ne zahtijevaju API ključ i ograničene su po IP adresi.
- GET
/api/company/{slug}Uwierzytelnienie: PubliczneZakres:read:company - GET
/api/company/{slug}/scoreUwierzytelnienie: PubliczneZakres:read:company - GET
/api/company/{slug}/reviewsUwierzytelnienie: PubliczneZakres:read:company - GET
/api/passport/{id}Uwierzytelnienie: PubliczneZakres:read:passport - POST
/api/passportUwierzytelnienie: Klucz APIZakres:write:passport - POST
/api/reviewsUwierzytelnienie: OpcjonalneZakres:write:review - POST
/api/suggested-editUwierzytelnienie: Klucz APIZakres:write:edit - POST
/api/webhooksUwierzytelnienie: Klucz APIZakres:write:webhook
Primjeri
curl "https://refurbscore.com/api/company/nomophone"Pomaknite u stranu za prikaz cijele naredbe.
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"}'Pomaknite u stranu za prikaz cijele naredbe.
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"]}'Pomaknite u stranu za prikaz cijele naredbe.
Events
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Security
- Sve operacije pisanja prolaze moderaciju administratora prije objave.
- API ključevi pohranjuju se kao SHA-256 sažeci — izvorni ključevi prikazuju se samo jednom, pri izradi.
- Dostarczenia webhooków powinny weryfikować X-Webhook-Signature (HMAC-SHA256).
- Svaki zahtjev bilježi se s metodom, putanjom, statusom, trajanjem i prefiksom ključa.