Nautilinks OpenAPI 3.1
Der vollständige REST-API-Vertrag: eindeutige operationIds, typisierte Parameter, Anfrage- und Antwortschemas, Authentifizierung und strukturierte Fehler.
openapi.json öffnen →Nautilinks Entwickler
Eine API für Menschen und KI-Agenten.
Durchsuchen Sie den Nautilinks-Katalog, bereiten Sie eine Bestellung vor, verfolgen Sie eine Veröffentlichung oder verbinden Sie direkt einen MCP-Client. REST, MCP und CLI verwenden dasselbe Konto, dieselben Preise und dieselben Schutzmechanismen.
REST-Schnellstart
Der erste Aufruf in weniger als einer Minute
- Erstellen Sie ein Nautilinks-Konto und erzeugen Sie anschließend im Mitgliederbereich einen
sn_test_…-Schlüssel für die Sandbox. - Senden Sie den Schlüssel ausschließlich im Header
Authorization: Bearer …. Speichern Sie ihn niemals in einer URL oder einem Repository. - Fragen Sie den Katalog ab. Ein Sandbox-Schlüssel verwendet echte Bestände und Preise, eine simulierte Bestellung belastet jedoch kein Guthaben und erzeugt keinen realen Verlagsauftrag.
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"Live-Schreibzugriffe erfordern einen sn_live_…-Schlüssel. Eine Bestellung kann vorausbezahltes Guthaben verbrauchen; lassen Sie Websites, Ankertexte, Ziel-URLs und Budget vor dem Live-Aufruf immer von einem Menschen bestätigen. Verwenden Sie nach einem Timeout denselben Idempotency-Key erneut.
Offizielle Schnittstellen
Wählen Sie den passenden Vertrag für Ihren Agenten
Nautilinks-MCP-Server
Der entfernte MCP-Server stellt Katalog, Artikel, Guthaben, Bestellungen und deren Status über Streamable HTTP bereit.
MCP-Leitfaden lesen →API-Authentifizierung
Bearer-Schlüssel erstellen, speichern und senden; read/order-Berechtigungen sowie Unterschiede zwischen Sandbox und Live.
Client authentifizieren →Webhooks Nautilinks
Abonnements, Bestellereignisse, HMAC-SHA256-Prüfung, Replay-Schutz und Widerruf.
Webhooks integrieren →Versionierung und Ratenbegrenzung
Stabilität von v1, RateLimit-Header, 429-Fehler, Vorankündigung von Deprecations und Sunset-Richtlinie.
API-Richtlinie lesen →Anweisungen für Agenten
Empfohlene Anwendungsfälle, Grenzen, minimaler Aufrufablauf, Bestätigung vor dem Kauf und Schutz der Schlüssel.
Agentenanweisungen lesen →Offizielles CLI
Abhängigkeitsfreier Node.js-Client zum Suchen, Vergleichen, Bestellen und Verfolgen über Terminal oder Automatisierung.
Paket herunterladen →MCP Streamable HTTP
Native Verbindung für KI-Agenten
Der entfernte Endpunkt lautet https://mcp.nautilinks.co/mcp. Die Initialisierung und das öffentliche Werkzeug about funktionieren ohne Schlüssel; Fachwerkzeuge verwenden einen Nautilinks-Bearer-Schlüssel. Lesen Sie den Nautilinks-MCP-Leitfaden und das öffentliche Manifest.
Webhooks
Status ohne Polling verfolgen
Registrieren Sie über die API eine öffentliche HTTPS-URL. Nautilinks signiert Bestellereignisse; prüfen Sie die Signatur vor der Verarbeitung, gestalten Sie den Consumer idempotent und antworten Sie zügig mit einem 2xx-Status. Der Nautilinks-Webhook-Leitfaden beschreibt die genaue Berechnung.
Vorhersehbare Fehler
Maschinenlesbares JSON zur Wiederherstellung
Jeder API-Fehler enthält ok, error, code, message und resolution. Antworten liefern außerdem das aktuelle Kontingent. Ein Agent kann seinen Aufruf korrigieren oder gemäß Retry-After warten, ohne HTML analysieren zu müssen.
Entwickler-Support
Benötigen Sie Hilfe bei der Integration?
Schreiben Sie an contact@nautilinks.co oder nutzen Sie die Kontaktseite. Nennen Sie MCP-Client, Operation, Fehlercode und Anfrage-ID — niemals Ihren geheimen Schlüssel.