Documentation

Vantro rend chaque entreprise achetable par les agents IA, et donne à chaque agent un seul branchement vers toutes les entreprises ouvertes et tous les outils du catalogue.

Adresse de l'API : https://votre-instance-ouvert

Démarrer en 2 minutes

1. Créer un compte

Depuis l'espace client, ou en une requête :

curl -X POST BASE/v1/accounts -H 'content-type: application/json' \
  -d '{"name":"Mon agent","email":"vous@exemple.com"}'
# → {"api_key":"vtr_sk_…", "account":{…}}

2. Brancher l'agent

# Claude Code
claude mcp add --transport http vantro BASE/mcp --header "Authorization: Bearer vtr_sk_…"

# Client sans en-têtes personnalisés
BASE/mcp?key=vtr_sk_…

3. Demander

L'agent dispose maintenant des outils ci-dessous. Exemple de demande : « Trouve les derniers dépôts SEC de Nvidia » : l'agent appelle find_and_buy, Vantro choisit l'outil, l'exécute et facture.

Outils MCP

Garantie : tout appel qui échoue (erreur, délai dépassé, établissement complet) est remboursé automatiquement.

Routage intelligent

POST /v1/route
{"need":"météo à Lyon cette semaine","params":{"latitude":45.76,"longitude":4.84},"max_price_eur":0.05}
# → {"status":"succeeded","chosen_tool":"geo.weather","result":{…},"attempts":[…]}

Vantro classe les candidats par pertinence puis par fiabilité mesurée, ignore ceux au-dessus de max_price_eur, essaie jusqu'à trois outils, et ne facture que celui qui répond.

Contrôle des dépenses

PATCH /v1/account/policy
{"per_tx_limit_eur":500,"daily_limit_eur":2000,"approval_above_eur":300,"allowed_categories":["voyage","données"]}

• Au-delà de approval_above_eur, l'achat passe en awaiting_approval ; un humain valide dans l'espace client ou via POST /v1/approvals/:id {"decision":"approve"}.
• Un solde insuffisant renvoie HTTP 402 avec le lien de recharge.

Vitrines d’entreprises

N’importe quelle entreprise s’ouvre aux agents à partir de son site : Vantro lit les données structurées schema.org, sinon les prix affichés (et, si une clé de modèle est configurée, une analyse IA du texte).

POST /v1/stores/analyze   {"url":"mon-site.fr"}            # aperçu : entreprise + offres détectées
POST /v1/stores           {"url":"mon-site.fr","email":"…"}  # crée la vitrine (brouillon) + clé vendeur
POST /v1/stores/:slug/open                                    # en ligne pour tous les agents
GET  /s/:slug                                                 # page publique de la vitrine
POST /s/:slug/mcp                                             # serveur MCP limité à cette vitrine

Une commande d’agent est payée d’avance et bloquée : l’entreprise confirme (POST /v1/provider/orders/:id/confirm) et elle est payée, ou refuse et le client est remboursé. Sans réponse sous 48 h, remboursement automatique. Suivi côté agent : outil order_status. Commission : 5 % sur les commandes confirmées.

Vendre sur Vantro

Trois façons de rendre un produit achetable par les agents. La commission n'est prélevée que sur les ventes réalisées.

Importer une API (OpenAPI 3, JSON)

POST /v1/providers/import-openapi        (Authorization: Bearer vtr_pk_…)
{
  "spec_url": "https://api.exemple.com/openapi.json",
  "price_eur_per_call": 0.01,
  "category": "données",
  "auth_header": {"name":"x-api-key","value":"VOTRE_CLE"},
  "operations": ["searchCompanies","getCompany"]      // facultatif
}

Votre clé n'est jamais montrée aux agents. Seules les URL https publiques sont acceptées.

Contrat webhook

POST votre_endpoint
x-vantro-signature: HMAC-SHA256(corps, signing_secret)
{"listing_id":"…","params":{…}}

→ 200 {"result":{…}, "charge_eur": 12.5}   // charge_eur facultatif (prix dynamique, plafonné au devis)
→ 4xx/5xx ou délai > 15 s : l'acheteur est remboursé

SDK

JavaScript

const { Vantro } = require('./vantro');
const c = new Vantro({ apiKey: 'vtr_sk_…', baseUrl: 'BASE' });
const r = await c.route('derniers dépôts SEC de Tesla', { ticker: 'TSLA' }, { maxPriceEur: 0.05 });

Python

from vantro import Vantro
c = Vantro("BASE", api_key="vtr_sk_…")
r = c.route("articles scientifiques sur les agents autonomes", {"query": "autonomous agents"})

Référence API