Data API v1

Acceso a datos de solo lectura y controlado por alcances.

Envíe la clave en el encabezado Authorization: Bearer. Nunca la incluya en una URL, en el almacenamiento del navegador ni en registros.

Centro de desarrolladoresProbar en el sandboxSolicitar acceso a producción

Primera solicitud

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

Endpoints

MétodoRutaAlcanceRespuesta
GET/v1/doctorsdoctors:readLista publicable de médicos
GET/v1/doctors/:iddoctors:readResumen público de un médico
GET/v1/doctors/:id/review-summaryreview-summaries:readResumen de fuente y distribución de valoraciones
GET/v1/proceduresprocedures:readLista canónica de procedimientos
GET/v1/procedures/:slugprocedures:readResumen publicado del hub de procedimientos

Límites de consulta

Las listas de médicos aceptan city, procedure, source, cursor, limit y locale. El limit máximo es 50. Los cursores están vinculados al conjunto de filtros.

Errores

  • 400 — consulta/cursor no válido
  • 401 — clave ausente, no válida, caducada o revocada
  • 403 — falta el alcance
  • 429 — cuota agotada; incluye Retry-After
  • 503 — contador seguro de cuota no disponible

Ejemplo de valoración de fuente

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

Atribución y campos excluidos

Conserve los nombres de las fuentes y las fechas de observación. Los textos sin procesar de reseñas, preguntas y respuestas o artículos; la identidad del paciente; los archivos de galería; los registros de consentimiento; las notas privadas; los embeddings; las auditorías; los prompts y los pesos de puntuación nunca aparecen en las respuestas v1.