Data API v1

Salt okunur, kapsam kontrollü veri erişimi.

Anahtarı Authorization: Bearer başlığında gönderin. Anahtarı URL’ye, tarayıcı depolamasına veya loglara yazmayın.

Geliştirici merkezi Sandbox’ta dene Canlı ortam erişimine başvur

İlk istek

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

Uç noktalar

Yöntem	Yol	Kapsam	Yanıt
GET	`/v1/doctors`	`doctors:read`	Yayınlanabilir doktor listesi
GET	`/v1/doctors/:id`	`doctors:read`	Tek doktorun public veri özeti
GET	`/v1/doctors/:id/review-summary`	`review-summaries:read`	Kaynak ve puan dağılımı özeti
GET	`/v1/procedures`	`procedures:read`	Canonical prosedür listesi
GET	`/v1/procedures/:slug`	`procedures:read`	Yayınlanmış prosedür hub özeti

Sorgu sınırları

Doktor listesinde city, procedure, source, cursor, limit ve locale kullanılabilir. limit en fazla 50’dir. Cursor filtre setine bağlıdır.

Hatalar

400 — geçersiz sorgu/cursor
401 — eksik, geçersiz, süresi dolmuş veya iptal edilmiş anahtar
403 — eksik kapsam
429 — kota aşıldı; Retry-After içerir
503 — güvenli kota sayacı kullanılamıyor

Kaynak puanı örneği

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

Atıf ve yasak alanlar

Yanıttaki kaynak adı ve tarih korunmalıdır. Ham yorum, soru-cevap veya makale metni; hasta kimliği; galeri; rıza belgesi; özel not; embedding; audit; prompt ve skor ağırlıkları hiçbir v1 yanıtında bulunmaz.