Versionsstabilität
Die aktuelle Basis-URL lautet https://nautilinks.co/api/v1/agent/. Kompatible Ergänzungen — neue optionale Eigenschaften, Operationen, Enum-Werte oder Fehlercodes — können innerhalb von v1 veröffentlicht werden. Das Entfernen oder Ändern eines Feldes, einer Operation, einer Authentifizierungsregel oder ihrer Bedeutung erfordert eine neue URL-Version. Jede Antwort enthält Nautilinks-API-Version: 1.
Deprecation und Sunset
API v1 ist aktiv und nicht als veraltet markiert. Wenn Nautilinks eine Version außer Betrieb nimmt, enthalten betroffene Antworten einen RFC-9745-Header Deprecation mit dem Deprecation-Datum, einen RFC-8594-Header Sunset mit dem letzten Servicedatum und einen Link mit rel="deprecation" zu den Migrationshinweisen.
Nautilinks gewährt normalerweise mindestens 90 Tage zwischen einer öffentlichen Deprecation-Ankündigung und dem Sunset. Ein kürzeres Zeitfenster ist dringenden Sicherheits-, Rechts- oder Missbrauchsschutzmaßnahmen vorbehalten; die Migrationsseite erläutert die Ausnahme.
Ratenbegrenzung
Die Agent API erlaubt 600 Anfragen pro festem 60-Sekunden-Fenster und Client-IP. Antworten enthalten die strukturierten IETF-HTTPAPI-Felder RateLimit-Policy und RateLimit sowie Kompatibilitätsaliasnamen. Eine Kontingentantwort verwendet HTTP 429, das standardisierte typisierte JSON-Fehlermodell und Retry-After. Agenten müssen für diese Dauer warten und dürfen nicht in einer engen Schleife erneut anfragen.
RateLimit-Policy: "agent-api";q=600;w=60
RateLimit: "agent-api";r=599;t=42
Nautilinks-API-Version: 1
Link: <https://nautilinks.co/de/entwickler/versionierung/>; rel="deprecation"Das separate rollierende Tageslimit für Bestellungen schützt Käufe. Wird es erreicht, folgen ebenfalls 429 und Retry-After. Es berechtigt einen Agenten nicht dazu, Schlüssel oder Konten zu wechseln, um das Limit zu umgehen.