Endpoints públicos

METHOD	PATH	PURPOSE
GET	`/api/commercial/catalog`	Catálogo canónico, precios y límites
GET	`/api/connections/catalog`	Proveedores, modos, scopes y requisitos humanos
POST	`/api/commercial/fit-assessments`	Recomendación determinista de plan
POST	`/api/commercial/navigator`	Orientación pública sin datos de clientes
POST	`/api/commercial/checkout-intents`	Inicio idempotente con email verificado
GET	`/api/commercial/checkout-intents/:id`	Estado no sensible
GET	`/api/commercial/openapi`	Contrato comercial OpenAPI
GET	`/api/openapi`	Contrato operativo y herramientas MCP

El objeto embeddedAgent se conserva por compatibilidad y declara consumo de Navigator y automatizaciones internas: ejecuciones mensuales, créditos IA, programaciones, concurrencia y BYOK. La interfaz principal para agentes externos sigue siendo MCP o API.

Ejemplo

curl https://platform.digitalpublic.com/api/commercial/catalog?locale=en

curl https://platform.digitalpublic.com/api/connections/catalog

curl -X POST https://platform.digitalpublic.com/api/commercial/fit-assessments \
  -H 'content-type: application/json' \
  -d '{"projects":1,"teamSize":1,"needsWrite":true,"wantsLiveData":true}'

Primeros pasos con un token

Los endpoints comerciales son públicos, pero la API operativa exige credencial. Envíala siempre en la cabecera Authorization: Bearer, tanto aquí como en el MCP operativo.

dpk_ es una API key de proyecto: el proyecto va implícito y no necesitas projectId.
dpa_ es un token de agente global: añade ?projectId=... o la cabecera X-DigitalPublic-Project-Id en las llamadas acotadas a proyecto.
Como alternativa, un cliente compatible puede obtener un access token mediante OAuth 2.0 Authorization Code con PKCE.
Guarda el token en la configuración del conector o en una variable de entorno. Nunca lo pegues en una conversación.

La primera llamada recomendada es POST /api/agent/discover: devuelve el proyecto, los scopes concedidos, los módulos disponibles y el catálogo de endpoints. Con un token global, GET /api/agent/projects lista antes los proyectos accesibles y sus scopes. El contrato completo está en https://platform.digitalpublic.com/api/openapi.

curl -X POST https://platform.digitalpublic.com/api/agent/discover \
  -H "Authorization: Bearer dpk_TU_API_KEY_DE_PROYECTO"

curl https://platform.digitalpublic.com/api/agent/projects \
  -H "Authorization: Bearer dpa_TU_TOKEN"

curl -X POST "https://platform.digitalpublic.com/api/agent/discover?projectId=YOUR_PROJECT_ID" \
  -H "Authorization: Bearer dpa_TU_TOKEN"

Regla de contratación

Un agente puede iniciar la intención, pero no completar silenciosamente el pago. DigitalPublic verifica el email y Stripe solicita la autorización del titular. Las propuestas Enterprise tampoco generan un contrato por sí solas.