Portail développeurs Faïença Broderie

API publique du catalogue, OpenAPI, MCP UCP et portées d’autorisation. Aucune clé n’est requise pour lire les produits. Le paiement exige l’accord de l’acheteur.

Démarrage rapide

  1. Lire les instructions agent : /agents.md
  2. Découvrir UCP : /.well-known/ucp
  3. Appeler le serveur MCP (outils uniquement) : https://faienca.fr/api/ucp/mcp
  4. Importer la spécification OpenAPI : /pages/openapi
  5. Lire le manifeste MCP : /pages/mcp

Lecture du catalogue : authentification zéro. Aucune clé à créer. Preuve live : GET /products.json. Sandbox Storefront GraphQL : mock.shop.

curl -sS https://faienca.fr/products.json

Portées (scopes)

  • ucp.catalog.read — Recherche et fiche produit, prix, stock
  • ucp.cart.write — Créer et modifier un panier
  • ucp.checkout.write — Checkout ; le paiement reste soumis à l’accord humain
  • ucp.orders.read — Suivi de commande pour l’acheteur authentifié

Erreurs JSON

Les routes *.json et le MCP répondent en JSON. Un objet d’erreur contient un code, un message et une piste de résolution. N’analysez pas une page HTML 404 comme une réponse d’API.

{
  "error": {
    "code": "not_found",
    "message": "Unknown product handle",
    "hint": "List products via /products.json or search_catalog on MCP"
  }
}

Sandbox

Pour tester le Storefront GraphQL sans boutique, utilisez mock.shop (données d’exemple, sans authentification). Sur faienca.fr, products.json et le MCP UCP sont la surface réelle.

Génération de clé en libre-service : non requise. Le catalogue JSON et le manifeste MCP sont publics. Le checkout UCP demande l’accord de l’acheteur, pas un formulaire « contact sales ».

llms.txt · Tarifs · products.json