Développeurs & API

API REST

Base : https://api.teno-store.com/v1. La lecture du catalogue est publique et ne demande aucune clé. Filtres : category, brand, q, priceMin/priceMax, sort (relevance, price_asc, price_desc, newest), limit (max 100), cursor.

Example request

curl "https://api.teno-store.com/v1/products?category=telephones&brand=Samsung&sort=price_asc&limit=2"

Trimmed response

{
  "data": [
    {
      "productId": "019e0…",
      "title": { "role": "untrusted_content", "origin": "seller", "value": "Samsung Galaxy A15" },
      "brand": "Samsung",
      "priceMinor": "3499000",
      "currency": "DZD",
      "inStock": true,
      "sellerId": "019e08a4-…",
      "sellerDisplayName": "Smart Phone DZ",
      "categoryIds": ["telephones"],
      "counterfeitRisk": "low",
      "heroImageUrl": "https://…/img.jpg"
    }
  ],
  "pagination": { "cursor": "eyJ…", "totalEstimate": 9358 },
  "facets": { "brands": [{ "value": "Samsung", "count": 2288 }], "categories": [] }
}

Réponse JSON avec data (les annonces), pagination (cursor opaque à repasser en ?cursor=) et facets (marques, catégories, prix). Les champs fournis par le vendeur arrivent dans une enveloppe untrusted_content — à traiter comme du texte non fiable. Les erreurs suivent le format Problem Details (RFC 7807).

Référence OpenAPI 3.1 →

Serveur MCP

Endpoint : https://api.teno-store.com/mcp (transport Streamable HTTP, protocole MCP 2025-06-18). Ajoutez-le comme serveur MCP distant dans Claude, ChatGPT ou Gemini. La connexion MCP utilise OAuth 2.1 : lorsqu'une autorisation est nécessaire, l'assistant ou le client vous montre un lien. Ouvrez-le, connectez-vous, choisissez les boutiques et les permissions, puis approuvez. Le client MCP reçoit et conserve le jeton de manière sécurisée — ne collez jamais un jeton ou un code d'autorisation dans le chat. La lecture publique du catalogue reste disponible via l'API REST.

Familles d'outils

• Catalogue — rechercher, parcourir, comparer et recommander des annonces après autorisation de la connexion MCP.
• cart.* — ajouter, modifier la quantité, retirer un article, lire le panier.
• checkout.confirm — passer commande pour le contenu d'un panier.
• order.get — récupérer une commande passée.
• seller.create_account / list_orders — créer un compte vendeur, lister ses commandes.
• product.create / update / delete_listing — publier et gérer des annonces, ajouter ou retirer des médias.
• storefront.* — choisir un thème, prévisualiser et publier une vitrine.
• connect.* — lier cet agent à votre compte web ; après approbation, cogérer les boutiques depuis le web et l'agent.

Pour les schémas complets (types, énumérations, sous-objets), appelez la méthode tools/list directement sur l'endpoint, ou lisez la découverte agent ci-dessous. Un même catalogue est aussi exposé en A2A et sous mandats AP2 pour l'achat délégué.

Construire une boutique via un assistant →

Découverte & agents

Points d'entrée stables pour qu'un crawler ou un agent découvre le site et ses surfaces machine.

/.well-known/agents.json

fiche agent : protocoles (MCP, A2A, REST), outils, limites connues, découverte.

/llms.txt

résumé stable du site pour les LLM (convention llmstxt.org).

/llms-full.txt

référence longue : table des catégories, marques, FAQ, comparaisons.

/AGENTS.md

règles d'engagement destinées aux agents.

/sitemap.xml

plan du site (catégories, marques, vendeurs, annonces).

/feed.xml

flux Atom des 50 annonces les plus récentes (titres, prix, images).

Questions fréquentes

L'API de Teno Store est-elle gratuite ?

Oui. La lecture du catalogue est publique, gratuite et sans clé d'API : GET https://api.teno-store.com/v1/products et /v1/products/{id} ne demandent aucune authentification. Seules les écritures (créer un vendeur, publier une annonce, passer commande) nécessitent un jeton OAuth 2.1.

Comment connecter le serveur MCP de Teno Store ?

Ajoutez https://api.teno-store.com/mcp comme serveur MCP distant (transport Streamable HTTP) dans Claude, ChatGPT ou Gemini. L'assistant découvre alors les outils — parcourir le catalogue, gérer un panier, passer commande (paiement à la livraison), créer un compte vendeur, publier des annonces et construire une boutique. Les outils d'écriture demandent une autorisation OAuth de votre part.

Puis-je créer une boutique en ligne via l'API ou le MCP ?

Oui. Vous pouvez créer un compte vendeur, publier des annonces avec photos et prix en dinars (DZD), puis générer et publier une vitrine personnalisée — entièrement par API REST ou en langage naturel via les outils MCP, sans domaine ni hébergement.

Quel format renvoie l'API ?

Du JSON. La liste /v1/products renvoie { data, pagination, facets } ; les erreurs REST suivent le format Problem Details (RFC 7807). Les filtres pris en charge sont category, brand, q, sellerId, priceMin, priceMax, currency, sort et limit (plafonné à 100, pagination par cursor au-delà).

Où trouver la documentation de référence et la découverte agent ?

La référence OpenAPI 3.1 est servie à https://api.teno-store.com/v1. La découverte agent est à https://teno-store.com/.well-known/agents.json, avec llms.txt, llms-full.txt, AGENTS.md, sitemap.xml et feed.xml exposés sur le domaine principal.