Service Doc

Documentation API publique Bullion Sniper

Cette page decrit la surface publique utile aux integrations et outils 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 pour outils de monitoring et integrations.

GET /api/public/best-offers

Meilleures offres visibles selon les filtres et le budget.

GET /api/public/product-prime

Lecture de prime par recherche produit comme napoleon ou souverain.

GET /api/public/cot-dashboard

Dashboard CFTC Commitment of Traders pour les metaux precieux.

GET /api/public/compare

Snapshot public du comparateur lu depuis Cloudflare KV.

GET /api/public/metal-prices

Cours retenus pour l'or et l'argent.

Outils publics

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 publics.

query

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

weeks

Nombre de semaines d'historique pour /api/public/cot-dashboard.

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 outils compatibles.

Guide technique
/agents

Vue d'ensemble des formats publics, MCP et WebMCP.

Exemples utiles

  • https://bullion-sniper.fr/api/public/market-snapshot?metal=or&maxBudget=800&quantity=1&site=all&countries=*&coins=*&lingots=false&fdp=true
  • https://bullion-sniper.fr/api/public/best-offers?metal=or&maxBudget=800&limit=5
  • https://bullion-sniper.fr/api/public/product-prime?metal=or&maxBudget=1200&query=napoleon
  • https://bullion-sniper.fr/api/public/cot-dashboard?weeks=52
  • https://bullion-sniper.fr/comparateur-achat-or-argent?metal=or&maxBudget=2000&quantity=1&site=all&lingots=false&fdp=true&countries=*&coins=*
  • https://bullion-sniper.fr/.well-known/api-catalog
  • https://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 technique

Pour une vue d'ensemble des formats publics, WebMCP et MCP, voir /agents.

Comparateur Guides