מפתחים
API RefurbScore
REST 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 הבסיסית. נקודות קצה “ציבוריות” אינן דורשות מפתח 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).
- כל בקשה נרשמת עם שיטה, נתיב, סטטוס, משך וקידומת מפתח.