Portal para desarrolladores de Faïença Broderie
API pública del catálogo, OpenAPI, MCP UCP y permisos. No se necesita ninguna clave para leer los productos. El pago siempre requiere la aprobación del comprador.
Inicio rápido
- Leer las instrucciones para agentes: /agents.md
- Descubrir UCP: /.well-known/ucp
-
Llamar al servidor MCP (solo herramientas):
https://faienca.fr/api/ucp/mcp - Importar la especificación OpenAPI: /pages/openapi
- Leer el manifiesto MCP: /pages/mcp
Lectura del catálogo: sin autenticación. No hay que crear ninguna clave. Prueba en vivo: GET /products.json. Sandbox de Storefront GraphQL: mock.shop.
curl -sS https://faienca.fr/products.json
Permisos (scopes)
ucp.catalog.read— Búsqueda y ficha de producto, precios, stockucp.cart.write— Crear y modificar un carritoucp.checkout.write— Checkout; el pago sigue requiriendo la aprobación humanaucp.orders.read— Seguimiento de pedidos para el comprador autenticado
Errores JSON
Las rutas *.json y el MCP responden en JSON. Un objeto de error contiene un código, un mensaje y una pista para resolverlo. No interpretes una página HTML 404 como una respuesta de la API.
{
"error": {
"code": "not_found",
"message": "Unknown product handle",
"hint": "List products via /products.json or search_catalog on MCP"
}
}
Sandbox
Para probar Storefront GraphQL sin tienda, usa mock.shop (datos de ejemplo, sin autenticación). En faienca.fr, products.json y el MCP UCP son la superficie real.
Generación de claves en autoservicio: no es necesaria. El catálogo JSON y el manifiesto MCP son públicos. El checkout UCP pide la aprobación del comprador, no un formulario de «contactar con ventas».