Deweloperzy
API RefurbScore
REST API dla danych firm, paszportów, opinii i integracji handlowych.
- Bazowy adres URL
https://refurbscore.com
Uwierzytelnianie
Punkty końcowe sprzedawcy wymagają klucza API (plan Pro). Przekaż swój klucz przez nagłówek Authorization Bearer lub X-API-Key.
Authorization: Bearer rs_live_…
# lub
X-API-Key: rs_live_…Przewiń w bok, aby zobaczyć całe polecenie.
Dostępne zakresy:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Niezależność oceny
API udostępnia oceny zaufania obliczone na podstawie zweryfikowanych danych. Płatne plany i dostęp przez API nigdy nie modyfikują ocen.
Limity zapytań
- Publiczne odczyty
- 60zapytań/min
- Uwierzytelnione
- 300zapytań/min
- Operacje zapisu
- 30zapytań/min
Odpowiedzi zawierają nagłówki X-RateLimit-Remaining i X-RateLimit-Reset.
Punkty końcowe
Ścieżki są podawane względem bazowego adresu URL. Endpointy oznaczone jako „Publiczne” nie wymagają klucza API i mają limit żądań na adres IP.
- 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
Przykłady
curl "https://refurbscore.com/api/company/nomophone"Przewiń w bok, aby zobaczyć całe polecenie.
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"}'Przewiń w bok, aby zobaczyć całe polecenie.
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"]}'Przewiń w bok, aby zobaczyć całe polecenie.
Zdarzenia
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Bezpieczeństwo
- Wszystkie operacje zapisu przechodzą przez moderację administracyjną przed publikacją.
- Klucze API są przechowywane jako skróty SHA-256 — surowe klucze są wyświetlane tylko raz podczas tworzenia.
- Dostarczenia webhooków powinny weryfikować X-Webhook-Signature (HMAC-SHA256).
- Każde zapytanie jest logowane z metodą, ścieżką, statusem, czasem trwania i prefiksem klucza.