Nautilinks Développeurs

Une API lisible par les humains et les agents.

Recherchez le catalogue Nautilinks, préparez une commande, suivez une publication ou branchez directement un client MCP. Le REST, le MCP et le CLI utilisent le même compte, les mêmes prix et les mêmes garde-fous.

OpenAPI 3.1 Documentation détaillée

Démarrage rapide REST

Premier appel en moins d’une minute

  1. Créez un compte Nautilinks, puis générez une clé sn_test_… dans l’espace membre pour travailler en sandbox.
  2. Envoyez la clé uniquement dans l’en-tête Authorization: Bearer …. Ne la placez jamais dans une URL ou un dépôt.
  3. Interrogez le catalogue. Une clé sandbox utilise les données et les prix réels, mais une commande simulée ne débite rien et ne crée aucune commande éditeur.
export NAUTILINKS_API_KEY="sn_test_…"

curl --fail-with-body \
  -H "Authorization: Bearer $NAUTILINKS_API_KEY" \
  "https://nautilinks.co/api/v1/agent/catalog?q=voyage&limit=5"

Les écritures live exigent une clé sn_live_…. Une commande peut consommer un solde prépayé ; faites toujours confirmer les sites, ancres, URLs cibles et le budget avant l’appel live. Réutilisez le même Idempotency-Key après un timeout.

Interfaces officielles

Choisissez le contrat adapté à votre agent

Nautilinks OpenAPI 3.1

Le contrat complet de l’API REST : operationId uniques, paramètres typés, schémas de requête et de réponse, authentification et erreurs structurées.

Ouvrir openapi.json →

Serveur MCP Nautilinks

Le serveur MCP distant expose le catalogue, les articles, le solde, les commandes et leur suivi via le transport Streamable HTTP.

Lire le guide MCP →

Authentification API

Création, stockage et transmission des clés Bearer, scopes read/order, différences entre clés sandbox et live.

Authentifier un client →

Webhooks Nautilinks

Abonnement, événements de commande, vérification HMAC-SHA256, protection anti-rejeu et révocation.

Intégrer les webhooks →

Versioning et rate limits

Stabilité de v1, en-têtes RateLimit, erreurs 429, préavis de dépréciation et politique de sunset.

Lire la politique API →

Instructions pour agents

Cas d’usage recommandés, limites, séquence d’appel minimale, confirmation avant achat et règles de protection des clés.

Lire les instructions →

CLI officiel

Client Node.js sans dépendance pour rechercher, comparer, commander et suivre depuis un terminal ou une automatisation.

Télécharger le paquet →

MCP Streamable HTTP

Connexion native pour les agents

Le point d’entrée distant est https://mcp.nautilinks.co/mcp. L’initialisation et l’outil public about fonctionnent sans clé ; les outils métier utilisent une clé Nautilinks en en-tête Bearer. Consultez le guide MCP Nautilinks et le manifeste public.

Webhooks

Suivre sans polling

Enregistrez une URL HTTPS publique avec l’API. Nautilinks signe les événements de commande ; vérifiez la signature avant tout traitement, rendez votre consommateur idempotent et répondez rapidement avec un statut 2xx. Le guide webhooks Nautilinks documente le calcul exact.

Erreurs prévisibles

Du JSON exploitable pour récupérer

Toute erreur API renvoie ok, error, code, message et resolution. Les réponses exposent aussi leur quota en temps réel. Un agent peut donc corriger son appel ou attendre le délai Retry-After sans analyser une page HTML.

Support développeurs

Besoin d’une intégration ?

Écrivez à contact@nautilinks.co ou utilisez la page de contact. Précisez votre client MCP, l’opération concernée, le code d’erreur et un identifiant de requête — jamais votre clé secrète.