कोई बैकएंड बदलाव आपके API के clients को न तोड़ दे, यह आप कैसे रोकते हैं?

contract को मशीन से जांचने लायक बनाएं। एक schema रखें, कोई OpenAPI दस्तावेज़ या protobuf definitions, जो कोड से बने या कोड के मुकाबले जांचे जाएं, और CI में एक compatibility जांच चलाएं जो breaking बदलाव पर fail हो, जैसे हटाया गया field या कसा हुआ type। अंदरूनी clients के लिए consumer driven contract tests जोड़ें, और events को उसी तरह version करें जैसे endpoints को करते हैं।

contract को ऐसी फाइल होना चाहिए जिसकी CI तुलना कर सके, वरना compatibility इस पर टिकी रहती है कि pull request की समीक्षा कौन कर रहा है। तो OpenAPI दस्तावेज़ repository में रहता है और handlers से बनता है, जिससे वह कल्पना बनकर बहकता नहीं, और एक job उसे main branch वाली प्रति से मिलाती है और किसी भी breaking चीज़ पर fail हो जाती है: हटाया गया field, नया ज़रूरी parameter, संकरा किया गया type। जोड़ना हमेशा चलता है। अंदरूनी consumers के लिए मुझे consumer driven contracts पसंद हैं, जहां हर client वह हिस्सा प्रकाशित करता है जिस पर वह सच में निर्भर है और मेरा build जांचता है कि मैं अब भी सबको पूरा करता हूं, तो मुझे build के समय पता चल जाता है, उनके on call से नहीं। events के साथ भी यही होता है, compatibility mode सेट किए हुए schema registry से, क्योंकि टूटा हुआ event payload टूटे endpoint से बुरा है, क्योंकि consumers asynchronously नाकाम होते हैं। और कुछ भी बदलने से पहले मैं per client request metrics देखता हूं, क्योंकि contract बताता है कि क्या संभव है और metrics बताते हैं कि असल में किसे फर्क पड़ेगा।