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

  1. Leer las instrucciones para agentes: /agents.md
  2. Descubrir UCP: /.well-known/ucp
  3. Llamar al servidor MCP (solo herramientas): https://faienca.fr/api/ucp/mcp
  4. Importar la especificación OpenAPI: /pages/openapi
  5. 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, stock
  • ucp.cart.write — Crear y modificar un carrito
  • ucp.checkout.write — Checkout; el pago sigue requiriendo la aprobación humana
  • ucp.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».

llms.txt · Precios · products.json