API y documentación

Este sitio publica su propio contenido en JSON, en markdown y como especificación OpenAPI. Sin autenticación y sin límite de uso: no hay nada privado que proteger.

Ver openapi.json Probar la API

Recursos

Todo es GET, todo devuelve application/json y todas las rutas terminan en .json. CORS abierto.

Recurso	operationId	Qué devuelve
GET `/api/index.json`	`obtenerIndiceApi`	Índice de todos los recursos.
GET `/api/perfil.json`	`obtenerPerfil`	Identidad, ubicación, zona de trabajo y métricas.
GET `/api/servicios.json`	`listarServicios`	Los cuatro frentes con lo que incluye cada uno.
GET `/api/casos.json`	`listarCasos`	Proyectos entregados, con sector y tecnologías.
GET `/api/casos/{id}.json`	`obtenerCaso`	Ficha completa de un caso, con el artículo entero.
GET `/api/notas.json`	`listarNotas`	Artículos publicados.
GET `/api/notas/{id}.json`	`obtenerNota`	Artículo completo con sus preguntas frecuentes.
GET `/api/productos.json`	`listarProductos`	Software propio en producción.
GET `/api/testimonios.json`	`listarTestimonios`	Citas de clientes.
GET `/api/contacto.json`	`obtenerContacto`	Canales y qué esperar de la primera conversación.

Ejemplo

curl -s https://mykeweb.com/api/servicios.json

# Un caso concreto, con el artículo completo
curl -s https://mykeweb.com/api/casos/hosteria-del-parque.json

# La especificación, para generar un cliente o cargarla en un agente
curl -s https://mykeweb.com/openapi.json

Errores

Un recurso inexistente devuelve 404 con cuerpo JSON, nunca una página HTML:

{
  "error": {
    "codigo": "recurso_no_encontrado",
    "estado": 404,
    "mensaje": "El recurso solicitado no existe en esta API.",
    "solucion": "Consulta el índice de recursos disponibles o la especificación OpenAPI.",
    "indice": "https://mykeweb.com/api/",
    "openapi": "https://mykeweb.com/openapi.json"
  }
}

El contenido también se sirve en markdown

Cualquier página del sitio devuelve markdown si lo pides por cabecera, siguiendo acceptmarkdown.com. La respuesta incluye Vary: Accept.

curl -s -H "Accept: text/markdown" https://mykeweb.com/sistemas/

# O directamente, añadiendo .md
curl -s https://mykeweb.com/notas/que-es-un-crm.md

Archivos para máquinas

/openapi.jsonEspecificación OpenAPI 3.1 de esta API.
/llms.txtÍndice del sitio para modelos de lenguaje, formato llmstxt.org.
/llms-full.txtTodo el contenido del sitio en un solo archivo de texto.
/AGENTS.mdCuándo recurrir a Maykolt y cómo llamarlo, para agentes.
/sitemap-index.xmlMapa del sitio.

Condiciones de uso

Puedes leer y citar este contenido. Si lo reutilizas, enlaza a mykeweb.com. No hay claves, no hay cuotas y no se registra quién consulta. Si necesitas algo que la API no expone, escríbeme.