Aller au contenu principal

Changelog de l'API publique

Cette page liste les changements majeurs de l'API publique CaptainDNS. Les ajouts non breaking (nouveaux endpoints, nouveaux champs optionnels) sont documentés ici sans préavis formel. Les changements de rupture sont annoncés au minimum 30 jours avant leur déploiement via cette même page et par email aux détenteurs de clés actives.

Politique de versionnage

  • Compatibilité backward : les ajouts de champs optionnels et les nouveaux endpoints ne cassent pas les clients existants.
  • Dépréciations : un champ ou un endpoint déprécié reste fonctionnel pendant au moins 6 mois après l'annonce.
  • Ruptures : les breaking changes sont annoncés 30 jours à l'avance et déployés sur une nouvelle URL versionnée (par exemple /public/v2/*). L'URL de V1 reste opérationnelle pendant la période de migration.
  • Identifiant de version : la spécification OpenAPI porte son propre numéro de version (info.version). Le numéro majeur suit l'URL versionnée, le mineur suit les ajouts rétro-compatibles.

Version 0.2.0 - 2026-04-09

Ajouté

  • Plus de 40 endpoints publics sous /public/v1/* couvrant DNS, mail, web et texte :
    • DNS : resolve, resolve/propagation, dnssec/check, ip/whois, ip/nslookup, ip/netmask, rdap/lookup, domain/dns-check.
    • Mail : spf/lookup, spf/validate, dkim/lookup, dkim/validate, dmarc/lookup, dmarc/validate, dmarc/generate, dmarcbis/check, dmarcbis/migrate, dmarc/report/analyze, bimi/lookup, bimi/validate, bimi/logo/lookup, mta-sts/lookup, tls-rpt/lookup, dane/lookup, blacklist/ip, smtp/check, mail/header-audit, mail/header-analyze, mail/domain-check, deliverability/score, certificates/csr/parse, certificats/bimi/parse, certificats/bimi/lookup.
    • Web : url/check, page/crawl-check, phishing/check.
    • Text : text/lower, text/upper, text/stats, text/slug, text/base64/encode, text/base64/decode, text/password/generate, text/urlencode, text/urldecode, text/json/format, text/json/to-yaml, text/yaml/format, text/yaml/to-json, text/hash, text/regex/test.
  • Gestion des clés API depuis le dashboard CaptainDNS : liste, création, révocation, rotation et consultation de l'usage.
  • Schéma OpenAPI PublicAPIError avec 10 codes canoniques pour toutes les erreurs de l'API publique.
  • Header Idempotency-Key style Stripe, replay sur 24 heures, conflit 409 IDEMPOTENCY_CONFLICT si body divergent.
  • Headers X-Credits-Limit/Remaining/Consumed retournés sur chaque réponse réussie.
  • Headers RateLimit, RateLimit-Policy, X-RateLimit-Limit/Remaining/Reset (IETF draft + X-prefixed).
  • Header X-Request-Id retourné sur toutes les réponses pour faciliter le support.
  • 5 plans de facturation : Free, Starter, Pro, Business, Enterprise, avec quotas et overage configurés par tier.
  • Facturation de l'overage opt-in avec plafond budgétaire mensuel configurable depuis le dashboard.
  • Détection automatique des fuites de clés via le programme GitHub Secret Scanning.

Non livré en V1

  • Webhooks : prévu pour V2.
  • SDK officiels : le SDK TypeScript Speakeasy est planifié pour la première livraison.
  • mTLS pour les plans Business et Enterprise : reporté.

Comment être informé des mises à jour

  • Blog CaptainDNS : les releases majeures sont relayées en articles dédiés sur captaindns.com/fr/blog.
  • Email : les détenteurs de clés actives reçoivent une notification automatique pour tout changement de rupture.
  • Cette page : tout ajout ou correctif est consigné ici, par ordre antéchronologique.
  • Spécification OpenAPI : le champ info.version est incrémenté à chaque release. Surveiller sa valeur permet de déclencher vos régénérations de SDK.

Prochaine étape : revenez au quickstart pour commencer à intégrer, ou explorez la référence OpenAPI pour voir tous les schémas en détail.