Stabilité des versions
L’URL de base actuelle est https://nautilinks.co/api/v1/agent/. Des ajouts compatibles — nouvelles propriétés optionnelles, opérations, valeurs d’enum ou codes d’erreur — peuvent être publiés dans v1. Supprimer ou modifier un champ, une opération, une règle d’authentification ou sa signification exige une nouvelle version d’URL. Chaque réponse contient Nautilinks-API-Version: 1.
Dépréciation et sunset
L’API v1 est active et n’est pas dépréciée. Lorsqu’une version sera dépréciée, les réponses concernées incluront un en-tête RFC 9745 Deprecation avec la date de dépréciation, un en-tête RFC 8594 Sunset avec la date finale de service et un lien rel="deprecation" vers le guide de migration.
Nautilinks accordera normalement au moins 90 jours entre l’avis public de dépréciation et le sunset. Une période plus courte sera réservée aux changements urgents de sécurité, de conformité ou de lutte contre les abus ; la page de migration expliquera l’exception.
Limites de débit
L’API Agent autorise 600 requêtes par fenêtre fixe de 60 secondes et par IP cliente. Les réponses exposent les champs structurés IETF HTTPAPI RateLimit-Policy et RateLimit, ainsi que des alias de compatibilité. Une réponse de quota utilise HTTP 429, le modèle d’erreur JSON typé et Retry-After. Les agents doivent attendre cette durée et ne jamais réessayer en boucle serrée.
RateLimit-Policy: "agent-api";q=600;w=60
RateLimit: "agent-api";r=599;t=42
Nautilinks-API-Version: 1
Link: <https://nautilinks.co/fr/developpeurs/versioning/>; rel="deprecation"Le plafond quotidien glissant des commandes protège séparément les achats. L’atteindre renvoie aussi 429 et Retry-After ; cela n’autorise pas un agent à changer de clé ou de compte pour contourner la limite.