Saltar al contenido

API para desarrolladores

Una API JSON de solo lectura que expone nuestras organizaciones publicadas y la taxonomía en un perfil compatible con HSDS (Open Referral, Human Services Data Specification 3.x). No se requiere clave.

Nivel de conformidad, con honestidad: este es un perfil HSDS parcial. Expone únicamente los objetos HSDS organization y taxonomy. No expone los objetos service, location, service_at_location, schedule ni contact, y no tiene geocoordenadas — nuestros datos están centrados en la organización (etiquetas de taxonomía sobre organizaciones), no a nivel de servicio. Las classifications de una organización son etiquetas de Open Eligibility y NTEE, no servicios HSDS descritos por separado.

Puntos de acceso (endpoints)

  • GET /api/hsds/v3Raíz autodescriptiva (perfil, versión, enlaces).
  • GET /api/hsds/v3/organizationsOrganizaciones publicadas, paginadas.
  • GET /api/hsds/v3/organizations/{id}Una sola organización por id.
  • GET /api/hsds/v3/taxonomiesLas tres taxonomías que publicamos.
  • GET /api/hsds/v3/taxonomy_termsTérminos de taxonomía; filtre con ?taxonomy=.

Notas

  • Paginación: ?page= y ?per_page= (20 por defecto, máximo 100); las respuestas usan el sobre (envelope) HSDS (total_items, total_pages, contents, links).
  • Los valores id de HSDS son UUIDv5 determinísticos derivados de nuestros ids nativos; el id nativo también se devuelve como external_identifier / code.
  • Las respuestas se almacenan en caché en el edge durante ~5 minutos.