Usar la REST API

Conceptos básicos

• Base URL: https://jenksguo.pages.dev/api/v1
• Sin autenticación para endpoints públicos. Las respuestas son JSON salvo que se indique lo contrario.
• Los endpoints GET permiten solicitudes de origen cruzado. POST /api/v1/ask tiene limitación de tasa por IP.
• Listas completas de parámetros: Referencia de la REST API.

Obtener el brief

curl -s https://jenksguo.pages.dev/api/v1/brief

El mismo brief está disponible como archivo en https://jenksguo.pages.dev/brief.md.

Listar entradas, con filtros

Todo el trabajo de Web3:

curl -s "https://jenksguo.pages.dev/api/v1/entries?tag=web3"

Solo roles de comunidad y gobernanza:

curl -s "https://jenksguo.pages.dev/api/v1/entries?kind=community"

Combina filtros: ?tag=consulting&lens=ai-transformation-consultant. Las etiquetas son it, engineering, ai, devrel, web3, business, marketing, consulting, hospitality, community y creative.

Obtener una entrada, traducida

curl -s "https://jenksguo.pages.dev/api/v1/entries/xero-developer-evangelist?locale=zh"

Locales admitidos: en (predeterminado), zh, zh-hant, ja, fr, es, eo. Los títulos oficiales de puesto y nombres de organizaciones permanecen en inglés en todos los locales.

Buscar

curl -s "https://jenksguo.pages.dev/api/v1/search?q=hackathons"

Los resultados son pasajes con el slug de la entrada o documento del que provienen. Continúa con /api/v1/entries/{slug}.

Leer un documento

curl -s https://jenksguo.pages.dev/api/v1/documents/credentials

Documentos: profile, credentials, capabilities, talks, thinking.

Preguntar al asistente

curl -s https://jenksguo.pages.dev/api/v1/ask \
  -H 'content-type: application/json' \
  -d '{"question": "What has Jenks built with AI agents?", "locale": "en"}'

Agrega turnos anteriores con "history": [{"role": "user", "content": "…"}, {"role": "assistant", "content": "…"}]. Si recibes 429, espera un minuto.

Ejemplo: crear una nota de preselección con jq

Los campos de respuesta están listados en la Referencia de la REST API.

curl -s "https://jenksguo.pages.dev/api/v1/entries?lens=developer-advocate" \
  | jq -r '.entries[] | "- \(.title) — \(.org) (\(.period)): \(.summary)"'

Alternativas estáticas

Si solo necesitas archivos, estos nunca cambian de forma y se almacenan bien en caché: /llms.txt, /llms-full.txt, /experience.json, /resume.json y /openapi.json.