Service Doc

Documentation API publique Bullion Sniper

Cette page decrit la surface publique utile aux agents et integrations de lecture. Elle couvre les endpoints publics simplifies, le comparateur natif, les metadonnees de decouverte et le serveur MCP en lecture seule expose par le site. Des alias de compatibilite sont aussi publies pour les discoverers qui attendent encore /openapi.json, /.well-known/mcp.json ou /.well-known/ai-plugin.json.

Endpoints publics

GET /api/public/market-snapshot

Snapshot standardise lisible par agents et outils de monitoring.

GET /api/public/best-offers

Meilleures offres visibles selon les filtres et le budget.

GET /api/public/product-prime

Lecture de prime par requete produit comme napoleon ou souverain.

GET /api/bullion/compare

Snapshot public du comparateur avec filtres URL.

GET /api/bullion/constants

Liste des types canoniques connus par le comparateur.

GET /api/bullion/pricing

Cours retenus pour l'or et l'argent.

POST /api/bullion/get-url

Resolution d'une URL marchande ou affiliee.

Tools publics pour agents

Les manifests MCP, OpenAPI et AI plugin convergent tous vers ces tools de lecture publique et de navigation partageable.

get_market_snapshot

Retourne un snapshot standardise du marche visible pour un jeu de filtres.

get_best_offers

Retourne les meilleures offres visibles selon budget, metal et site.

get_product_prime

Retourne une synthese de prime pour une recherche produit comme napoleon ou souverain.

build_comparator_url

Construit une URL de comparateur partageable a partir d'un jeu de filtres explicite.

get_comparator_snapshot

Alias legacy de compatibilite pour get_market_snapshot.

Parametres de filtre

metal

Choix du metal: or ou ar.

minBudget

Budget minimum en euros.

maxBudget

Budget maximum en euros.

quantity

Quantite cible maximale.

site

all, traditional, ebay_europe ou ebay_fr.

countries

Liste CSV de pays, ou * pour tous.

coins

Liste CSV de familles ou * pour toutes.

lingots

true ou false pour inclure les lingots.

fdp

true ou false pour inclure les frais de port.

limit

Nombre max de lignes pour les endpoints agents.

query

Texte libre pour /api/public/product-prime.

Ressources de decouverte

API catalog
/.well-known/api-catalog

Point d'entree machine-readable pour decouvrir les APIs publiques.

OpenAPI public
/.well-known/service-desc/public-bullion-api.json

Description machine des endpoints publics les plus utiles.

OpenAPI compatibility alias
/openapi.json

Alias de compatibilite pour les scanners qui attendent /openapi.json.

Status public
/.well-known/status/bullion-api.json

Etat synthetique du service public de comparaison.

MCP server card
/.well-known/mcp/server-card.json

Carte de decouverte du serveur MCP public en lecture seule.

Legacy MCP manifest alias
/.well-known/mcp.json

Alias de compatibilite pour les scanners qui cherchent encore mcp.json.

Legacy AI plugin manifest
/.well-known/ai-plugin.json

Manifest OpenAI plugin de compatibilite avec les discoverers plus anciens.

Agent skills index
/.well-known/agent-skills/index.json

Index des competences publiees pour les agents.

Guide AI agents
/agents

Vue d'ensemble orientee discovery, crawl, MCP et WebMCP.

Exemples utiles

  • https://www.bullion-sniper.fr/api/public/market-snapshot?metal=or&maxBudget=800&quantity=1&site=all&countries=*&coins=*&lingots=false&fdp=true
  • https://www.bullion-sniper.fr/api/public/best-offers?metal=or&maxBudget=800&limit=5
  • https://www.bullion-sniper.fr/api/public/product-prime?metal=or&maxBudget=1200&query=napoleon
  • https://www.bullion-sniper.fr/comparateur-achat-or-argent?metal=or&maxBudget=2000&quantity=1&site=all&lingots=false&fdp=true&countries=*&coins=*
  • https://www.bullion-sniper.fr/.well-known/api-catalog
  • https://www.bullion-sniper.fr/mcp

Authentification

Le comparateur public reste lisible sans session. Certaines routes de compte restent protegees. Le site publie une metadonnee /.well-known/oauth-authorization-server et une metadonnee /.well-known/oauth-protected-resource pour documenter le point de token actuellement disponible.

Usage agents

Pour une vue d'ensemble orientee crawl, discovery, WebMCP et MCP, voir /agents.