API pública de Medics Services

Catálogo de servicios médicos en Cartagena de Indias, legible por máquina. Solo lectura, sin autenticación, sin registro.

Qué es y qué no es. Esto expone el catálogo: qué servicios presta Medics Services y a qué precio. No agenda citas ni crea pedidos. Reservar exige valoración previa y, en sueroterapia, consentimiento informado firmado; eso no se cierra por API. Para agendar, el camino es WhatsApp al (+57) 305 356 4220.

Inicio rápido

No hay clave que pedir. Una petición y ya:

curl https://medics.services/wp-json/wc/store/v1/products?per_page=5

Buscar un servicio

curl "https://medics.services/wp-json/wc/store/v1/products?search=holter"

Un servicio concreto

curl https://medics.services/wp-json/wc/store/v1/products/123

Especificación

La ficha OpenAPI 3.1 está en /openapi.json. Describe únicamente rutas que responden: no hay endpoints documentados que no existan.

Endpoints

Método y ruta	Qué devuelve
`GET /products`	Lista de servicios con nombre, precio y categoría. Admite `search` y `per_page`.
`GET /products/{id}`	Un servicio.
`GET /products/categories`	Las categorías del catálogo.

Base: https://medics.services/wp-json/wc/store/v1

Errores

Siempre JSON, nunca HTML. Un objeto con código estable, mensaje legible y estado:

{
  "code": "woocommerce_rest_product_invalid_id",
  "message": "ID de producto no válido.",
  "data": { "status": 404 }
}

Estado	Cuándo
`400`	Parámetro fuera de rango o mal formado.
`404`	El recurso no existe.
`429`	Demasiadas peticiones seguidas. Espera y reintenta.

Límites

El sitio está en alojamiento compartido y su borde limita las ráfagas. Deja al menos dos segundos entre peticiones. No es una cuota publicada: es una observación medida, y sin respetarla llegan 429 y 504 que no son culpa de tu código.

Versiones y retirada

La versión va en la ruta (/wc/store/v1). Compromiso:

Dentro de una versión no se quitan ni se renombran campos. Solo se añaden.
Un cambio incompatible estrena versión nueva; la anterior sigue en pie.
Antes de retirar una versión se anuncia con las cabeceras Deprecation y Sunset (RFC 8594) durante al menos 6 meses, y se avisa en esta página.

Otros formatos

Recurso	Para qué
`/llms.txt`	Índice del sitio para modelos, con cuándo usarlo.
`/cualquier-ruta.md`	Cualquier página en Markdown. También por `Accept: text/markdown`.
`/sitemap_index.xml`	Todas las URLs.

Sobre Accept: text/markdown. Funciona, pero la caché del servidor puede adelantarse y devolver HTML, y Vary: Accept no sobrevive a esa capa. Si necesitas garantía, usa el sufijo .md: es otra URL y no comparte entrada de caché.

Contacto

Medics Services · Calle 31D #73-46, Los Alpes, Cartagena de Indias
WhatsApp y teléfono: (+57) 305 356 4220
Correo: comercial@medics.services