v3 API में ब्रेकिंग और उल्लेखनीय बदलाव। हम इसका पालन करते हैं semver — एडिटिव बदलाव (नए वैकल्पिक पैरामीटर, नए एक्शन, रिस्पॉन्स में नई फ़ील्ड) एक major वर्शन के भीतर आते हैं; ब्रेकिंग बदलाव एक नए major में जाते हैं।
services और catalog actions अब दस supported languages में curated market terminology से localized service names के लिए optional language code लेते हैं। Explicit request canonical-name और actual-language metadata जोड़ती है तथा missing या stale translation पर safely English fallback करती है। language के बिना legacy English response shape unchanged रहता है। Admins हर नाम की समीक्षा या refinement कर सकते हैं।
/api/v3 canonical endpoint और familiar reseller contract का direct base-URL replacement बना। v3 optional exact retry keys, 60-second legacy duplicate protection, advanced catalog, numeric IDs, refund_quote, account_status, single/bulk cancel, सात-दिन unresolved refund, batch status/refill और signed webhooks जोड़ता है। API throughput अब lifetime successful spend tier और account की सभी keys द्वारा shared एक rolling 60-second window इस्तेमाल करता है। /api/v1 और /api/v2 इसी current contract के exact aliases हैं।
पृष्ठों में बँटा catalog और केवल पढ़ने योग्य refund_quote कार्य जोड़े गए, add और status मेटाडेटा बढ़ाया गया, API के सामान्य ऑर्डर के लिए 15 सेकंड की रद्दीकरण अवधि और मूल निर्माण के 7 दिन बाद भी अनसुलझे सामान्य ऑर्डर के लिए पूरा रिफंड जोड़ा गया। API वेबहुक इवेंट में अब स्थिर इवेंट id होता है, जबकि उसी बैच के पुनः प्रयासों में deliveryId स्थिर रहता है; हर पुनः प्रयास को नया टाइमस्टैम्प और हस्ताक्षर मिलता है। वेबहुक डिलीवरी पुनः प्रयासों के साथ यथासंभव होती है, कम से कम एक बार डिलीवरी की टिकाऊ गारंटी नहीं है।
Google, Rumble, Audiomack, Tumblr, Kwai, Clubhouse, Vimeo, Deezer, Tidal, Apple Music, Quora, और GitHub के लिए सेवाएं जोड़ी गईं। वे किसी भी अन्य सर्विस की तरह services एक्शन में दिखती हैं और हर एक का एक समर्पित सार्वजनिक प्लेटफ़ॉर्म पेज है। कोई क्लाइंट बदलाव आवश्यक नहीं — नए सर्विस ID बस कैटलॉग में दिखने लगते हैं।
Unavailable services नया order चुपचाप accept या queue करने की जगह action=add अस्वीकार करती हैं। Retry से पहले catalog refresh करें और available service चुनें।
add action अब supported service-type-specific optional fields स्वीकार करता है, जैसे start delay और per-type engagement options। Service type द्वारा पहले से defined fields अपना documented meaning रखते हैं।
add action dripfeed=true वाली services के लिए runs और interval साथ स्वीकार करता है। कुल delivery quantity × runs है और service maximum से अधिक नहीं हो सकती। Non-drip services दोनों fields अस्वीकार करती हैं।
Form-encoded v2 action API को rate controls, retries वाले signed best-effort webhooks और idempotent order placement के साथ launch किया गया। मौजूदा v1 और v2 URLs, v3 contract के aliases हैं और documented shared account limit इस्तेमाल करते हैं।