ConnectBuy publica una Content API pública de solo lectura para que agentes e integraciones consulten qué es ConnectBuy, el modelo CPV, las preguntas frecuentes, el glosario y los datos de la empresa. Sin autenticación, solo peticiones GET.
Especificación: https://www.connectbuy.app/openapi.json (OpenAPI 3.1). Catálogo RFC 9727: https://www.connectbuy.app/.well-known/api-catalog. Descubrimiento: https://www.connectbuy.app/api/index.json.
Versionado por ruta URL: la versión actual es v1 (https://www.connectbuy.app/api/v1/). Endpoints: GET /api/v1/pages.json, GET /api/v1/faqs.json, GET /api/v1/glossary.json y GET /api/v1/glossary/{slug}.json (p. ej. cpv), GET /api/v1/company.json. Las rutas desconocidas bajo /api/ devuelven un cuerpo JSON de error (código, mensaje, sugerencia) con estado HTTP 404.
Los cambios que rompan compatibilidad se publican bajo /api/v2/; la versión anterior se mantiene hasta su fecha de sunset, anunciada en https://www.connectbuy.app/api/versions.json y mediante las cabeceras Deprecation (RFC 9745) y Sunset (RFC 8594) con al menos 180 días de aviso. Los cambios aditivos se publican dentro de v1 sin aviso.
Todas las respuestas de la API llevan cabeceras RateLimit (RateLimit, RateLimit-Policy y el trío RateLimit-Limit/Remaining/Reset) para que los agentes se auto-regulen; un 429 incluiría Retry-After.
El CLI oficial connectbuy envuelve la Content API: instálalo con "npm install -g connectbuy" y ejecuta "connectbuy faq", "connectbuy glossary cpv", "connectbuy company" o "connectbuy versions". Añade --json para la respuesta cruda. Repositorio: packages/cli.
/llms.txt es la guía para agentes con la sección "cuándo usar ConnectBuy". /sitemap.xml lista todas las URLs públicas. Cada página incorpora JSON-LD schema.org (Organization, WebSite, SoftwareApplication), enlaces rel="service-desc"/"service-doc"/"service-meta" en el head, y responde en text/markdown vía la cabecera Accept.
La API transaccional (atribución de ventas, métricas por sede, activación de campañas) está en beta privada. Para credenciales y un entorno de sandbox, escribe a conecta@connectbuy.app indicando tu caso de uso.