Data API v1

وصول للقراءة فقط مضبوط بنطاقات الصلاحية.

أرسل المفتاح في ترويسة Authorization: Bearer. لا تضعه مطلقًا في عنوان URL أو تخزين المتصفح أو السجلات.

مركز المطورين التجربة في Sandbox طلب الوصول إلى الإنتاج

الطلب الأول

curl 'https://api.doctorhub.ai/v1/doctors?city=Istanbul&limit=20' \
  -H 'Authorization: Bearer dh_v1_<key-id>.<secret>'

{
  "data": [{
    "id": 123,
    "slug": "ornek-doktor",
    "name": "Op. Dr. Örnek Doktor",
    "city": "İstanbul",
    "scorehub": { "value": 8.4, "scale": 10, "as_of": "2026-09-13T10:00:00Z" },
    "badges": []
  }],
  "page": { "next_cursor": null, "limit": 20 }
}

نقاط النهاية

الطريقة	المسار	النطاق	الاستجابة
GET	`/v1/doctors`	`doctors:read`	قائمة أطباء قابلة للنشر
GET	`/v1/doctors/:id`	`doctors:read`	ملخص عام لطبيب واحد
GET	`/v1/doctors/:id/review-summary`	`review-summaries:read`	ملخص المصدر وتوزيع التقييم
GET	`/v1/procedures`	`procedures:read`	قائمة الإجراءات المعتمدة
GET	`/v1/procedures/:slug`	`procedures:read`	ملخص منشور لمركز الإجراء

حدود الاستعلام

تقبل قوائم الأطباء city وprocedure وsource وcursor وlimit وlocale. الحد الأقصى لـ limit هو 50، ويرتبط cursor بمجموعة الفلاتر.

الأخطاء

400 — استعلام أو cursor غير صالح
401 — المفتاح مفقود أو غير صالح أو منتهي أو ملغى
403 — النطاق مفقود
429 — نفدت الحصة؛ تتضمن Retry-After
503 — عداد الحصة الآمن غير متاح

مثال تقييم المصدر

{
  "source": "realself",
  "rating": 4.8,
  "rating_scale": 5,
  "source_review_count": 120,
  "ingested_review_count": 84,
  "rated_sample_count": 82,
  "source_url": "https://www.realself.com/...",
  "fetched_at": "2026-09-13T10:00:00Z"
}

نسب المصدر والحقول المستبعدة

يجب الحفاظ على أسماء المصادر وتواريخ الرصد. لا تظهر في استجابات v1 النصوص الخام للمراجعات أو الأسئلة والأجوبة أو المقالات، ولا هوية المريض أو وسائط المعرض أو سجلات الموافقة أو الملاحظات الخاصة أو embeddings أو سجلات التدقيق أو prompts أو أوزان التقييم.