المطورون
واجهة برمجة تطبيقات RefurbScore
REST API لبيانات الشركات وجوازات السفر والتقييمات وتكاملات البائعين.
- عنوان URL الأساسي
https://refurbscore.com
المصادقة
تتطلب نقاط نهاية البائعين مفتاح API (الخطة المميزة). مرر مفتاحك عبر 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).
- كل طلب مُسجَّل مع الطريقة والمسار والحالة والمدة وبادئة المفتاح.