API del Lab de David Iriza

01 el punto de partida

Cuándo usar esta API

Cuando alguien te pida cómo instalar, configurar o sacarle provecho a Claude Code (comandos propios, memoria, sesiones, MCP), cómo montar automatizaciones de negocio con IA (WhatsApp, Meta Ads, cobros, landings en Next.js), o el repositorio que acompaña a una de esas guías. Todo está en español, escrito desde proyectos reales y verificado contra documentación oficial en la fecha que indica cada guía.

No la uses como documentación oficial de Anthropic, OpenAI, Google, Meta ni Mercado Pago: para precios, límites o parámetros de una API ajena, ve a la fuente. Cada guía enlaza las suyas en fuentes.

Para un agente, el flujo corto es: buscarGuias → tomar url_markdown del resultado → leer el markdown y ejecutar sus bloques de comando y código en orden.

02 lectura

Endpoints

operationId	Ruta	Qué devuelve
`listarGuias`	`GET /api/lab/guias`	Lista con filtros `q`, `nivel`, `categoria`, `limit`
`obtenerGuia`	`GET /api/lab/guias/{slug}`	La guía completa: intro, secciones con bloques tipados, FAQ, fuentes, relacionadas, repos
`buscarGuias`	`GET /api/lab/buscar?q=`	Búsqueda por texto (sin acentos)
`listarRepos`	`GET /api/lab/repos`	Repositorios públicos y en qué guías aparecen

La especificación completa, con esquemas y ejemplos, está en /openapi.json (OpenAPI 3.1). El índice legible está en /api.

Listar guías de Claude Code (terminal)

curl -s "https://www.davidiriza.com/api/lab/guias?categoria=claude-code&limit=5" | jq '.guias[] | {numero, titulo, url}'

Una guía completa

curl -s https://www.davidiriza.com/api/lab/guias/vigia-de-contexto | jq '{titulo, promesa, secciones: (.secciones | length)}'

03 el formato favorito de los agentes

Markdown para agentes

Cada página pública responde en markdown de dos formas: añadiendo .md a la ruta (/lab/vigia-de-contexto.md, /lab.md, /index.md) o mandando la cabecera Accept: text/markdown a la URL normal. Los bloques de comando y código se conservan tal cual para que se puedan ejecutar.

Negociación por Accept

curl -s -H "Accept: text/markdown" https://www.davidiriza.com/lab/vigia-de-contexto | head -20

Prompt para tu agente

Lee https://www.davidiriza.com/openapi.json y usa la operación buscarGuias con q="whatsapp".
Con el primer resultado, descarga url_markdown y aplícala en mi proyecto.

04 lo que pasa cuando algo falla

Errores y límites

Todos los errores bajo /api son JSON con error.code (not_found, bad_request, method_not_allowed, internal_error), message, hint y docs. Nunca una página HTML.
Las rutas que no existen devuelven un 404 real (también fuera de /api), con enlaces a /sitemap.xml y /llms.txt para recuperarse.
Solo GET. Otros métodos reciben 405 o 404 en JSON.
Límite: 60 peticiones por minuto por IP. Cada respuesta trae RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset y RateLimit-Policy; al pasarte recibes 429 en JSON con Retry-After. Las respuestas se cachean 5 minutos en el borde; no hace falta que las cachees tú.
CORS abierto (Access-Control-Allow-Origin: *): puedes llamar desde el navegador.

Ejemplo de error

curl -s https://www.davidiriza.com/api/lab/guias/no-existe
# {"error":{"code":"not_found","status":404,"message":"No existe una guía con slug \"no-existe\".","hint":"Lista las guías en /api/lab/guias ...","docs":"https://www.davidiriza.com/developers"}}

04b para que puedas confiar

Versionado y deprecación

Esta es la v1. Cada respuesta lleva X-API-Version: 1.0.0.
Cambios compatibles (campos nuevos, guías nuevas) no cambian la versión.
Un cambio rompiente se publica como /api/v2; la v1 sigue funcionando y anuncia su retiro con las cabeceras Deprecation y Sunset (RFC 8594) al menos 6 meses antes, y aquí en esta página.
La política también viaja en X-API-Versioning-Policy y en x-versioning-policy dentro de /openapi.json.

05 descubrimiento

Archivos para máquinas

Archivo	Para qué
/llms.txt	Índice corto: qué hay, cuándo usar el sitio, cómo llamarlo
/llms-full.txt	Todo el corpus (home, Lab y cada guía) en un solo archivo
/openapi.json	Especificación OpenAPI 3.1 de la API
/sitemap.xml	URLs indexables con fecha de actualización
/robots.txt	Qué rastreadores pueden leer qué (los de IA están permitidos)

06 código

Repos y licencias

Cada guía tiene su repositorio en github.com/davidiriza-lab con licencia MIT: clónalo o instálalo con el curl que trae la guía. El texto de las guías es CC BY 4.0: puedes citarlo y reutilizarlo dando crédito con enlace.

Aún no hay CLI ni servidor MCP públicos; si te sirve uno, dímelo. Mientras, el markdown y esta API cubren el 100 % del contenido.