Los endpoints públicos no necesitan clave · OpenAPI 3.1 · Errores RFC 9457
Documentación para desarrolladores.
Todo lo que un agente o un ingeniero necesita para llamar a ecentic: una API REST versionada, un servidor MCP, errores tipados, límites de uso publicados y los documentos de descubrimiento que permiten encontrarlo todo sin intervención humana.
Llama a ecentic en una sola petición
La superficie pública no requiere autenticación y admite CORS. Empieza aquí y genera una clave solo cuando necesites actuar sobre la cuenta de un comercio.
Cada endpoint público responde en JSON, envía cabeceras de límite de uso en tiempo real y apunta a su propia descripción legible por máquinas mediante una cabecera Link.
Descubre la superficie
Una petición devuelve todos los endpoints, la política de versionado, la política de límites de uso y dónde están documentados los errores.
curl -s https://ecentic.ai/api/v1Lee el mapa de protocolos
MCP, UCP, ACP, OpenAPI y x402 con sus versiones, transportes y la ubicación de sus manifiestos.
curl -s https://ecentic.ai/api/v1/discoveryConsulta el catálogo de planes
Los mismos precios que muestra la página de precios, en unidades mínimas legibles por máquinas.
curl -s https://ecentic.ai/api/v1/plansAutenticación
Las lecturas públicas son abiertas. Todo lo que toca la cuenta de un comercio requiere una clave bearer.
ecentic emite claves de API de larga duración una vez que una persona crea una cuenta. Crea la cuenta, genera una clave desde el panel o con la herramienta MCP autenticada `create_api_key` y envíala como token bearer en cada llamada protegida. La clave se muestra una sola vez.
Las llamadas protegidas sin una clave válida devuelven HTTP 401 y una cabecera `WWW-Authenticate` que nombra el documento de metadatos del recurso protegido, de modo que un agente puede repetir el descubrimiento a partir del propio fallo en lugar de adivinar.
- `mcp` — llamar a las herramientas MCP del endpoint de ecentic
- `onboarding` — conectar tiendas de Shopify, WooCommerce y feeds de productos
curl -s https://ecentic.ai/api/mcp \
-H "Authorization: Bearer ecentic_sk_..." \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'Endpoints
La superficie REST versionada. Las rutas bajo /api/v1 son estables durante toda la vida de v1.
| Método | Ruta | Auth | Resumen |
|---|---|---|---|
| GET | /api/v1 | Público | Index of the public ecentic agent API. |
| GET | /api/v1/health | Público | Liveness of the ecentic service. |
| GET | /api/v1/discovery | Público | Every machine-readable discovery document ecentic publishes, by protocol. |
| GET | /api/v1/plans | Público | Public ecentic plan catalog with prices and billing mode. |
| GET | /api/v1/skills | Público | Agent skills ecentic publishes, with their SKILL.md locations. |
| POST | /api/mcp | Clave bearer | MCP JSON-RPC endpoint (tools/list, tools/call). |
| GET | /api | Pago x402 | x402-payable agent API root. |
Protocolos de agentes
ecentic habla los protocolos de comercio y herramientas que los agentes ya usan, y publica un manifiesto para cada uno.
| Protocolo | Versión | Endpoint | Manifiesto |
|---|---|---|---|
| Model Context Protocol | 2025-03-26 | /api/mcp | /.well-known/mcp.json |
| Universal Commerce Protocol | 2026-04-08 | /ucp | /.well-known/ucp |
| Agentic Commerce Protocol | 2026-01-30 | /api/acp | /.well-known/acp.json |
| OpenAPI | 3.1.0 | /api/v1 | /openapi.json |
| x402 | 1 | /api | /openapi.json |
Errores, límites y versiones
Los tres contratos de los que depende una integración, cada uno documentado en su propia página y legible por máquinas.
Errores tipados
Cada fallo es application/problem+json con un código estable legible por máquinas y una pista de resolución.
Límites de uso
Cabeceras RateLimit en tiempo real en cada respuesta y Retry-After en un 429, para que un agente se autorregule.
Versionado
La versión va en la ruta, con cabeceras Deprecation y Sunset antes de retirar nada.
Servidor MCP
Claude, ChatGPT y cualquier cliente MCP pueden llamar a ecentic de forma nativa.
El servidor MCP de ecentic habla JSON-RPC 2.0 sobre HTTP y está disponible tanto en `/mcp` como en `/api/mcp`. Su manifiesto se publica en la ruta well-known convencional y como tarjeta de servidor SEP-1649.
Las herramientas de solo lectura (`list_plans`) funcionan sin autenticación. Las que cambian el estado de la cuenta — crear claves, iniciar un pago, conectar una tienda — necesitan una clave bearer.
- `list_plans` — planes y su disponibilidad en Stripe
- `create_api_key` — generar una clave de agente de larga duración
- `create_checkout` — abrir una sesión de pago de Stripe
- `connect_shopify`, `connect_woocommerce`, `connect_feed` — conexión de tiendas
curl -s https://ecentic.ai/.well-known/mcp.json | jq .transportWebhooks
ecentic recibe webhooks; todavía no los envía.
Los endpoints entrantes verifican la firma y rechazan cualquier petición que no la supere antes de ejecutar ningún handler. Los webhooks de cumplimiento de Shopify verifican un HMAC, Stripe verifica su propia cabecera de firma y los endpoints de socios verifican un secreto bearer.
Los webhooks salientes — ecentic notificando a tu sistema cuando termina un escaneo o se vuelve a publicar una ficha — aún no están disponibles. Hasta entonces, consulta la superficie REST o suscríbete a través de la sesión MCP.
Línea de comandos
Automatiza ecentic sin escribir un cliente HTTP.
La CLI de ecentic envuelve la misma superficie pública documentada aquí — descubrimiento, planes, skills, estado y llamadas a herramientas MCP — para que un agente o una persona desarrolladora pueda usar la terminal en lugar de construir una integración.
Lee `ECENTIC_API_KEY` del entorno para los comandos autenticados e imprime JSON en stdout, de modo que todos los comandos se componen con `jq`.
npx @ecentic/cli discovery
npx @ecentic/cli plans
ECENTIC_API_KEY=ecentic_sk_... npx @ecentic/cli mcp tools/listTodos los documentos de esta página son legibles por máquinas y accesibles sin clave.
¿Listo para ser el producto que recomiendan los agentes?
Instálalo gratis en Shopify o WooCommerce y mira tu puntuación de IA en minutos.
Instalar en Shopify
Instalar en WooCommerce
© 2026 ecentic. Todos los derechos reservados.
Hecho para comercios que se niegan a ser invisibles para la IA.