Developers & API

REST API

Base: https://api.teno-store.com/v1. Reading the catalog is public and requires no key. Filters: 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": [] }
}

JSON response with data (the listings), pagination (cursor opaque, pass it back as ?cursor=) and facets (brands, categories, prices). Seller-supplied fields arrive in an untrusted_content envelope — treat them as untrusted text. Errors follow the Problem Details format (RFC 7807).

OpenAPI 3.1 reference →

MCP server

Endpoint: https://api.teno-store.com/mcp (Streamable HTTP transport, MCP protocol 2025-06-18). Add it as a remote MCP server in Claude, ChatGPT or Gemini. The MCP connection uses OAuth 2.1: when authorization is needed, the assistant or client shows you a link. Open it, sign in, choose the shops and permissions, and approve. The MCP client receives and stores the credential securely—never paste a token or authorization code into chat. Public catalog reading remains available through the REST API.

Tool families

• Catalog — search, browse, compare and recommend listings after the MCP connection is authorized.
• cart.* — add, change quantity, remove an item, read the cart.
• checkout.confirm — place an order for the contents of a cart.
• order.get — retrieve a placed order.
• seller.create_account / list_orders — create a seller account, list its orders.
• product.create / update / delete_listing — publish and manage listings, add or remove media.
• storefront.* — pick a theme, preview and publish a storefront.
• connect.* — link this agent to your web account; approve once to co-manage shops from web and agent.

For the full schemas (types, enums, sub-objects), call the tools/list method directly on the endpoint, or read the agent discovery below. The same catalog is also exposed over A2A and under AP2 mandates for delegated purchasing.

Build a store through an assistant →

Discovery & agents

Stable entry points so a crawler or an agent can discover the site and its machine surfaces.

/.well-known/agents.json

agent card: protocols (MCP, A2A, REST), tools, known limits, discovery.

/llms.txt

stable site summary for LLMs (llmstxt.org convention).

/llms-full.txt

long reference: table of categories, brands, FAQ, comparisons.

/AGENTS.md

rules of engagement aimed at agents.

/sitemap.xml

site map (categories, brands, sellers, listings).

/feed.xml

Atom feed of the 50 most recent listings (titles, prices, images).

Frequently asked questions

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.