Data API v1

Schreibgeschützter, berechtigungsbasierter Datenzugriff.

Senden Sie den Schlüssel im Header Authorization: Bearer. Speichern Sie ihn niemals in einer URL, im Browser-Speicher oder in Protokollen.

EntwicklerzentrumIn der Sandbox testenProduktionszugang beantragen

Erste Anfrage

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 }
}

Endpunkte

MethodePfadBerechtigungAntwort
GET/v1/doctorsdoctors:readVeröffentlichungsfähige Arztliste
GET/v1/doctors/:iddoctors:readÖffentliche Zusammenfassung eines Arztes
GET/v1/doctors/:id/review-summaryreview-summaries:readQuellen- und Bewertungsverteilungsübersicht
GET/v1/proceduresprocedures:readKanonische Eingriffsliste
GET/v1/procedures/:slugprocedures:readVeröffentlichte Zusammenfassung des Eingriffs-Hubs

Abfragegrenzen

Arztlisten akzeptieren city, procedure, source, cursor, limit und locale. Das maximale limit beträgt 50. Cursor sind an die Filterkombination gebunden.

Fehler

  • 400 — ungültige Abfrage/ungültiger Cursor
  • 401 — fehlender, ungültiger, abgelaufener oder widerrufener Schlüssel
  • 403 — fehlende Berechtigung
  • 429 — Kontingent ausgeschöpft; enthält Retry-After
  • 503 — sicherer Kontingentzähler nicht verfügbar

Beispiel einer Quellenbewertung

{
  "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"
}

Quellenangabe und ausgeschlossene Felder

Quellennamen und Beobachtungsdaten müssen erhalten bleiben. Rohe Bewertungs-, Frage-Antwort- oder Artikeltexte, Patientenidentitäten, Galeriemedien, Einwilligungsnachweise, private Notizen, Embeddings, Audits, Prompts und Bewertungsgewichte erscheinen niemals in v1-Antworten.