Προγραμματιστές
RefurbScore API
- Βασική διεύθυνση URL
https://refurbscore.com
Πιστοποίηση
Τα τελικά σημεία εμπόρου απαιτούν κλειδί API (πλάνο Pro). Περάστε το κλειδί σας μέσω της κεφαλίδας Authorization Bearer ή X-API-Key.
Authorization: Bearer rs_live_…
# ή
X-API-Key: rs_live_…Κάντε κύλιση πλευρικά για να διαβάσετε ολόκληρη την εντολή.
Διαθέσιμα πεδία εφαρμογής:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Ανεξαρτησία βαθμολογίας
Το API εκθέτει βαθμολογίες εμπιστοσύνης υπολογισμένες από επαληθευμένα δεδομένα. Τα πληρωμένα πλάνα και η πρόσβαση API δεν τροποποιούν ποτέ τις βαθμολογίες.
Όρια ρυθμού
- Δημόσιες αναγνώσεις
- 60αίτ./λεπτό
- Πιστοποιημένο
- 300αίτ./λεπτό
- Λειτουργίες εγγραφής
- 30αίτ./λεπτό
Οι απαντήσεις περιλαμβάνουν κεφαλίδες X-RateLimit-Remaining και X-RateLimit-Reset.
Τελικά σημεία
Οι διαδρομές είναι σχετικές με τη βασική διεύθυνση URL. Τα «δημόσια» endpoints δεν απαιτούν κλειδί API και έχουν όριο αιτημάτων ανά διεύθυνση IP.
- GET
/api/company/{slug}Πιστοποίηση: ΔημόσιοΠεδίο εφαρμογής:read:company - GET
/api/company/{slug}/scoreΠιστοποίηση: ΔημόσιοΠεδίο εφαρμογής:read:company - GET
/api/company/{slug}/reviewsΠιστοποίηση: ΔημόσιοΠεδίο εφαρμογής:read:company - GET
/api/passport/{id}Πιστοποίηση: ΔημόσιοΠεδίο εφαρμογής:read:passport - POST
/api/passportΠιστοποίηση: Κλειδί APIΠεδίο εφαρμογής:write:passport - POST
/api/reviewsΠιστοποίηση: ΠροαιρετικόΠεδίο εφαρμογής:write:review - POST
/api/suggested-editΠιστοποίηση: Κλειδί APIΠεδίο εφαρμογής:write:edit - POST
/api/webhooksΠιστοποίηση: Κλειδί APIΠεδίο εφαρμογής:write:webhook
Παραδείγματα
curl "https://refurbscore.com/api/company/nomophone"Κάντε κύλιση πλευρικά για να διαβάσετε ολόκληρη την εντολή.
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"}'Κάντε κύλιση πλευρικά για να διαβάσετε ολόκληρη την εντολή.
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"]}'Κάντε κύλιση πλευρικά για να διαβάσετε ολόκληρη την εντολή.
Συμβάντα
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Ασφάλεια
- Όλες οι λειτουργίες εγγραφής εισέρχονται στην εποπτεία διαχειριστή πριν τη δημοσίευση.
- Τα κλειδιά API αποθηκεύονται ως κατακερματισμοί SHA-256 — τα ακατέργαστα κλειδιά εμφανίζονται μία φορά κατά τη δημιουργία.
- Οι παραδόσεις webhook πρέπει να επαληθεύονται μέσω του X-Webhook-Signature (HMAC-SHA256).
- Κάθε αίτημα καταγράφεται με μέθοδο, διαδρομή, κατάσταση, διάρκεια και πρόθεμα κλειδιού.