Entwickler
RefurbScore API
REST-API für Unternehmensdaten, Pässe, Bewertungen und Händler-Integrationen.
- Basis-URL
https://refurbscore.com
Authentifizierung
Händler-Endpunkte erfordern einen API-Schlüssel (Pro-Plan). Übergeben Sie Ihren Schlüssel via Authorization Bearer oder X-API-Key Header.
Authorization: Bearer rs_live_…
# oder
X-API-Key: rs_live_…Scrollen Sie seitwärts, um den ganzen Befehl zu lesen.
Verfügbare Bereiche:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Score-Unabhängigkeit
Die API gibt Vertrauens-Scores aus verifizierten Daten zurück. Bezahlte Pläne und API-Zugriff beeinflussen niemals die Scores.
Ratenbegrenzungen
- Öffentliche Lesezugriffe
- 60Anfragen/Min.
- Authentifiziert
- 300Anfragen/Min.
- Schreiboperationen
- 30Anfragen/Min.
Antworten enthalten X-RateLimit-Remaining und X-RateLimit-Reset Header.
Endpunkte
Pfade sind relativ zur Basis-URL. „Öffentliche“ Endpunkte benötigen keinen API-Schlüssel und sind pro IP-Adresse ratenbegrenzt.
- GET
/api/company/{slug}Auth: ÖffentlichBereich:read:company - GET
/api/company/{slug}/scoreAuth: ÖffentlichBereich:read:company - GET
/api/company/{slug}/reviewsAuth: ÖffentlichBereich:read:company - GET
/api/passport/{id}Auth: ÖffentlichBereich:read:passport - POST
/api/passportAuth: API-SchlüsselBereich:write:passport - POST
/api/reviewsAuth: OptionalBereich:write:review - POST
/api/suggested-editAuth: API-SchlüsselBereich:write:edit - POST
/api/webhooksAuth: API-SchlüsselBereich:write:webhook
Beispiele
curl "https://refurbscore.com/api/company/nomophone"Scrollen Sie seitwärts, um den ganzen Befehl zu lesen.
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"}'Scrollen Sie seitwärts, um den ganzen Befehl zu lesen.
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"]}'Scrollen Sie seitwärts, um den ganzen Befehl zu lesen.
Ereignisse
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Sicherheit
- Alle Schreiboperationen durchlaufen die Admin-Moderation vor der Veröffentlichung.
- API-Schlüssel werden als SHA-256-Hashes gespeichert — Rohschlüssel werden nur einmalig bei der Erstellung angezeigt.
- Webhook-Lieferungen sollten X-Webhook-Signature (HMAC-SHA256) verifizieren.
- Jede Anfrage wird mit Methode, Pfad, Status, Dauer und Schlüsselpräfix protokolliert.