Vývojáři
API RefurbScore
REST API dla danych firm, pasů, recenzí i integracji handlowych.
- Základní URL
https://refurbscore.com
Uwierzytelnianie
Punkty koncowe prodejce wymagaja klucza API (plan Pro). Przekaz swoj klucz przez naglowek Authorization Bearer lub X-API-Key.
Authorization: Bearer rs_live_…
# nebo
X-API-Key: rs_live_…Posunutím do strany zobrazíte celý příkaz.
Dostepne zakresy:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Niezaleznosc skore
API udostepnia skore důvěry obliczone na podstawie ověřených danych. Platne plany i dostep przez API nigdy nie modyfikuja skore.
Limity zapytan
- Publiczne odczyty
- 60zapytan/min
- Uwierzytelnione
- 300zapytan/min
- Operacje zapisu
- 30zapytan/min
Odpowiedzi zawieraja naglowki X-RateLimit-Remaining i X-RateLimit-Reset.
Punkty koncowe
Cesty jsou relativní k základní URL. Endpointy označené „Veřejné“ nevyžadují klíč API a mají omezený počet požadavků na IP adresu.
- 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
Przyklady
curl "https://refurbscore.com/api/company/nomophone"Posunutím do strany zobrazíte celý příkaz.
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"}'Posunutím do strany zobrazíte celý příkaz.
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"]}'Posunutím do strany zobrazíte celý příkaz.
Zdarzenia
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Bezpieczenstwo
- Všechny operacje zapisu przechodza przez moderacje administracyjna przed publikacja.
- Klucze API sa przechowywane jako skroty SHA-256 — surowe klucze sa wyswietlane tylko raz podczas tworzenia.
- Dostarczenia webhookow powinny weryfikowac X-Webhook-Signature (HMAC-SHA256).
- Kazde zapytanie jest logowane z metoda, sciezka, statusem, czasem trwania i prefiksem klucza.