Portal de desarrolladores
Todo lo que hay acá es público y no necesita credenciales. Está pensado para agentes y para cualquier integración que quiera leer el catálogo de servicios, el blog o el portafolio sin raspar HTML.
Tres comandos para tener el mapa completo del sitio: el índice, el contrato y una página cualquiera en markdown.
curl -s https://humancreativelab.cl/llms.txt
curl -s https://humancreativelab.cl/openapi.json
curl -s -H "Accept: text/markdown" https://humancreativelab.cl/serviciosLa versión mayor va en la ruta: /api/v1/…. Dentro de una versión mayor solo se agregan campos y endpoints; nada se quita ni cambia de tipo. Un cambio incompatible estrena una versión mayor nueva, y la anterior sigue respondiendo al menos 12 meses desde el anuncio.
Cada respuesta declara con qué versión te contestamos en Api-Version. Cuando una versión quede marcada para retirarse, sus respuestas viajarán además con Deprecation (RFC 9745) y Sunset (RFC 8594) con la fecha exacta, así que un cliente se entera leyendo cabeceras y no revisando esta página.
Las rutas sin versión, como /api/health, son alias permanentes de la versión vigente y no se van a retirar.
curl -sI https://humancreativelab.cl/api/v1/siteLa API pública acepta 200 peticiones por minuto y por IP. El estado del límite viaja en todas las respuestas, no solo cuando se agota: RateLimit como campo estructurado (RFC 9331) y las X-RateLimit-* de siempre, para que puedas regular el ritmo antes de chocar.
RateLimit: limit=200, remaining=197, reset=54
RateLimit-Policy: 200;w=60
X-RateLimit-Remaining: 197Al superarlo la respuesta es 429 con Retry-After en segundos. No hay bloqueo permanente: pasada la ventana vuelves a tener cupo.
La superficie pública no usa claves: son lecturas de contenido ya publicado. No hay nada que pedir ni que rotar.
La API de administración de contenidos sí está autenticada y no es pública. Si necesitas acceso de escritura para una integración, escríbenos desde contacto y lo conversamos.
Cualquier URL pública devuelve markdown si lo pides. Hay dos formas equivalentes, y la respuesta siempre lleva Vary: Accept para que las cachés no mezclen representaciones.
curl -s -H "Accept: text/markdown" https://humancreativelab.cl/faq
curl -s https://humancreativelab.cl/faq.mdUn Accept que no podamos satisfacer devuelve 406, y una ruta inexistente devuelve 404 con un cuerpo markdown que lista las secciones del sitio: un agente perdido siempre recibe el camino de vuelta.
/api/v1/siteFicha del sitio
Identidad, casos de uso y puntos de entrada, con campos en vez de prosa. Es por donde conviene empezar: dice si este dominio resuelve la tarea antes de leer una sola página.
curl -s https://humancreativelab.cl/api/v1/site/api/v1/pagesÍndice de páginas publicadas
Todas las URL públicas con su sección, su fecha de modificación y la URL de su representación markdown. Acepta los parámetros section y limit.
curl -s "https://humancreativelab.cl/api/v1/pages?section=servicios&limit=10"/api/v1/servicesCatálogo de servicios
Qué construimos, con el enlace al detalle de cada servicio y a su versión markdown.
curl -s https://humancreativelab.cl/api/v1/services/api/v1/projectsPortafolio publicado
Proyectos entregados, con el sitio del cliente cuando sigue en línea: es la evidencia verificable de lo que hemos construido.
curl -s https://humancreativelab.cl/api/v1/projects/api/healthEstado del sitio
Responde sin autenticación y sin caché. Devuelve el estado y el commit desplegado, así que sirve para saber si lo que estás leyendo es la versión actual. Su equivalente versionado es /api/v1/health.
curl -s https://humancreativelab.cl/api/health/llms.txtÍndice del sitio para agentes
Todas las URL publicadas, agrupadas por sección, en markdown. Se arma desde el mismo sitemap que leen los buscadores, así que nunca queda desfasado.
curl -s https://humancreativelab.cl/llms.txt/openapi.jsonEspecificación OpenAPI 3.1
Contrato completo de la superficie pública: rutas, parámetros, esquemas de respuesta y forma de los errores.
curl -s https://humancreativelab.cl/openapi.json/{ruta}.mdCualquier página en markdown
Toda página pública tiene representación markdown. Se pide con el sufijo .md o con la cabecera Accept: text/markdown. El contenido sale de la misma página, no de un segundo árbol que mantener.
curl -s https://humancreativelab.cl/servicios.md/api/chatbot/providersProveedores de IA configurados
Lista los proveedores y modelos que el asistente del sitio tiene disponibles.
curl -s https://humancreativelab.cl/api/chatbot/providers/api/chatbot/messageConversar con el asistente
Recibe el historial de la conversación y responde en streaming (text/event-stream). Está limitado por IP; la cabecera X-RateLimit-Remaining dice cuánto queda.
curl -N -X POST https://humancreativelab.cl/api/chatbot/message \
-H "Content-Type: application/json" \
-d '{"slug":"human-creative-lab","messages":[{"role":"user","content":"¿Qué hacen?"}]}'Todo error de la API pública responde JSON con la misma forma. El campo code es estable: ramifica por él, no por el texto del mensaje.
{
"error": {
"code": "not_found",
"status": 404,
"message": "No existe el endpoint GET /api/inventado.",
"hint": "Revisa la especificación OpenAPI en /openapi.json para ver los endpoints disponibles y sus métodos.",
"documentation": "https://humancreativelab.cl/developers",
"specification": "https://humancreativelab.cl/openapi.json"
}
}| code | HTTP | Cuándo aparece |
|---|---|---|
| not_found | 404 | La ruta no existe en la API pública. |
| method_not_allowed | 405 | La ruta existe pero no acepta ese método. |
| bad_request | 400 | Faltan campos obligatorios o vienen mal formados. |
| unsupported_media_type | 415 | El cuerpo no viene en un tipo que el endpoint acepte. |
| rate_limited | 429 | Se superó el límite por IP. Reintenta más tarde. |
| upstream_unavailable | 503 | Un servicio del que dependemos no responde. |
| internal_error | 500 | Error nuestro. Si se repite, escríbenos. |
@humancreativelab/cli envuelve todo lo anterior para que un agente o un script no tenga que armar peticiones a mano. No necesita instalación previa ni configuración.
npx @humancreativelab/cli health
npx @humancreativelab/cli sitemap
npx @humancreativelab/cli read /servicios
npx @humancreativelab/cli search "landing page"
npx @humancreativelab/cli openapiCada comando acepta --json para salida estructurada y --base para apuntar a otro despliegue.
Retry-After.