Calculateur de versionnement d'API
Calculez les versions d'API simultanées et le multiplicateur de coût de maintenance à partir des versions actives, de la période de dépréciation et de la fréquence de publication.
Comment utiliser le calculateur de versionnement d'API
- Entrez le nombre de versions d'API actuellement actives.
- Entrez la période de support de dépréciation en mois.
- Entrez la fréquence de publication en mois.
- Cliquez sur Calculer pour voir les versions simultanées et le coût de maintenance.
Cas d'utilisation
- •Planification de la stratégie de versionnement d'API pour les API de plateforme.
- •Estimation du coût de maintenance des longues périodes de dépréciation.
- •Élaboration du dossier commercial pour des fenêtres de support plus courtes.
- •Conception de politiques de cycle de vie des API pour les plateformes développeurs.
Formule
Versions simultanées = ceil(période de dépréciation / fréquence de publication) + 1. Multiplicateur de maintenance = versions simultanées / versions actives.
Questions fréquemment posées
Combien de temps dois-je prendre en charge les anciennes versions d'API ?
La norme du secteur est un préavis de dépréciation de 6 à 12 mois. Les grandes API (Stripe, Twilio) prennent en charge les versions pendant 2 ans ou plus.
Comment communiquer la dépréciation d'une version ?
Utilisez l'en-tête HTTP Sunset, des notices de dépréciation dans la documentation, des notifications par e-mail aux consommateurs d'API et des dates de fin de support.
Versionnement par URL ou par en-tête ?
Le versionnement par URL (/v1/ressource) est plus visible et mis en cache. Le versionnement par en-tête (Accept : application/v2+json) est plus propre mais moins découvrable.