גישה למפתחים ולסוכני AI

אותם פרופילים, מסננים וכללי התאמה באתר, ב־JSON וב־MCP.

קריאה בלבד, ללא חשבון או מפתח API. מזהה יחיד לכל פרופיל: doctor:מספר־רישיון.

הוראות לסוכנים · מדריך מלא · OpenAPI · נקודת כניסה ל־API · מדיניות API

REST — גרסה 3

• חיפוש לפי שם, רישיון או התמחות — search?q=cardiology
• פרופיל מלא — fetch?id=doctor:26310
• התמחות וערי מרפאה — find?specialty=cardiology&region=center
• רופאים בולטים בתחום — recommendations?specialty=urology
• קטלוג התמחויות — specialty-catalog
• ערים, אזורים ובתי חולים — city-catalog

תשובות מכילות apiVersion, documentationUpdated, data, links, meta. דפדוף עם limit של 1–100 ו־offset של 0–100000. שגיאות: 400 לבקשה לא תקינה, 404 לפרופיל חסר.

MCP

https://www.docdb.co.il/api/v1/mcp — Streamable HTTP ללא מצב מתמשך, פרוטוקול 2025-03-26. שולחים POST עם Content-Type: application/json ו־Accept: application/json, text/event-stream. לאחר initialize שולחים notifications/initialized, ואז tools/list או tools/call. GET מחזיר 405.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "find_doctors",
    "arguments": {
      "specialty": "hand-surgery",
      "region": "center",
      "limit": 20
    }
  }
}

• search — Find Israeli doctors by name, licence or specialty. One result per registry identity with stable doctor:{licence} IDs and canonical links.
• fetch — Fetch one canonical physician profile using a doctor:{licence} ID. Accepted legacy IDs resolve to the same profile; unresolved source records return not found.
• find_doctors — Search registry-based doctor profiles by certified specialty, clinic city/area and accepted hospital affiliation. Hospital location is never clinic location. Unmatched sources are excluded.
• doctor_profile — Retrieve one doctor by licence number or doctor:{licence} ID. Registry dates, certified specialties and accepted source enrichment remain distinguished.
• recommend_doctors — Return editorial prominent-doctor selections with hospital leadership or published recognition. Not clinical quality or patient outcomes. Filters apply to the same canonical identities.
• compare_doctors — Compare facts for 2–4 different canonical doctor identities. Does not choose a clinical winner.
• specialty_catalog — List certified specialties, counts and editorial specialty categories.
• city_catalog — Clinic cities, six editorial regions and accepted hospital labels with deduplicated counts.
• check_registered_specialty — Check whether a specialty is listed for an exact name or licence in the registry snapshot. Ambiguous names are never resolved by filtering specialty.

ייצוגים וגרסאות

לכל פרופיל דף ב־/doctors/מספר־רישיון, JSON באמצעות fetch ו־Markdown ב־/text/doctor:מספר־רישיון. מפות האתר כוללות רק את הכתובות הקנוניות. מזהים ישנים שהותאמו מחזירים אותו פרופיל; מזהי מקור לא פתורים אינם מפורסמים.

גרסה 3 מחליפה את התוצאות הנפרדות לכל מקור בפרופיל מאוחד. כלים ישנים לשליפת רשומות מקור הוסרו; הנחיות מעבר. התאמה לפי כללים אינה אימות זהות עצמאי. כללי הנתונים והניקוד.