n8n अब सार्वजनिक API दर सीमा प्रदान करता है जो आपके उदाहरण पर हर टीम को चलाने के लिए रखता है।
n8n 2.47.0 में सभी योजनाओं के लिए प्रति-कुंजी सार्वजनिक API दर सीमाएं पेश की गई हैं। व्यवस्थापक वैश्विक रूप से या प्रत्येक एंडपॉइंट पर पढ़ने और लिखने की छत निर्धारित कर सकते हैं, उन्हें सेटिंग्स, API, या पर्यावरण चर के माध्यम से सक्षम कर सकता है, और बहु-मुख्य सेटअप में Redis पर निर्भर हो सकता है। ओवरलिमिट अनुरोधों को पुनः प्रयास करने के बाद 429 प्रतिक्रियाएँ प्राप्त होती हैं, जिससे ग्राहकों को सुरक्षित रूप से वापस जाने में मदद मिलती है। idempotency कुंजियों के साथ संयुक्त, यह सुविधा भागने वाले वर्कफ़्लो को साझा उदाहरणों को दबाने से रोकती है, जबकि n8N और HTTP Request नोड्स में बैचिंग स्वचालित कार्यप्रवाहों को सीमा के भीतर रखता है।
मुख्य जानकारी
- n8n 2.47.0 सभी योजनाओं में प्रति-कुंजी सार्वजनिक API दर सीमाएं पेश करता है, जो साझा किए गए उदाहरणों के भारी होने से भागने वाले वर्कफ़्लो को रोकने में मदद करता है।
- व्यवस्थापक 429 प्रतिक्रियाओं और पुनः प्रयास मार्गदर्शन हेडर के साथ सेटिंग पृष्ठ, API, या पर्यावरण चर के माध्यम से वैश्विक रूप से या प्रति एंडपॉइंट अलग-अलग पढ़ने / लिखने की सीमा को सक्षम और कॉन्फ़िगर कर सकते हैं।
- API क्लाइंट्स को रेट-लिमिट हेडर का पालन करके रिट्री-अफ्टर का सम्मान करना चाहिए, जिटर जोड़ना चाहिए और शेष कोटा की निगरानी करनी चाहिए जबकि वर्कफ़्लो को प्रति आइटम से बचने के लिए बैचिंग का उपयोग करना चाहिए।
- केवल / API /v1 के विरुद्ध API कुंजी का उपयोग करने वाले अनुरोध सीमाओं की ओर गिनती करते हैं; संपादक यातायात को बाहर रखा गया है, और प्रत्येक कुंजी में एक ही विन्यस्त सीमा के भीतर अपना काउंटर होता है.
- n8n 2.45.0 के बाद से उपलब्ध idempotency कुंजियाँ, दोहराए गए POST अनुरोधों को रोककर और पुनः प्रयासों के लिए संग्रहीत प्रतिक्रियाओं को वापस करके दर सीमा के बाद पुनरावृत्तियों को सुरक्षित बनाती हैं।
मेटा विवरण: n8n 2.47.0 प्रति-कुंजी सार्वजनिक API दर सीमाओं और idempotency कुंजियों को जोड़ता है, टीमों की मदद से रनवे वर्कफ़्लोज़ को कैप करता है और साझा किए गए एन 8 एन उदाहरणों की रक्षा करता है।
टैगः n8n, API दर सीमित करना, स्वचालन कार्यप्रवाह, सार्वजनिक API, idempotency कुंजी
n8n सार्वजनिक API दर सीमाएं n8N 2.47.0 में आईं, और वे सभी योजनाओं पर उपलब्ध हैं। यह सुविधा प्रशासकों को एक उदाहरण के लिए कितने अनुरोध भेजने की अनुमति देती है, इसलिए अन्य टीमों को अवरुद्ध करने के बजाय रनवे वर्कफ़्लो अपनी स्वयं की कुंजी सीमा से टकराता है। यह idempotency कुंजियों के साथ भी काम करता है, जो कि n8ne 2.45.0 के बाद से उपलब्ध है, ताकि ग्राहक सीख सकें कि कब धीमा करना है और जब पुनः प्रयास सुरक्षित हो।
प्रति-कुंजी सीमा क्यों मायने रखती है
साझा किए गए n8n उदाहरण सार्वजनिक API को एक सामान्य निर्भरता में बदल देते हैं। विभिन्न टीमों के ग्राहक इसे कॉल करते हैं, और वर्कफ़्लोज़ उसी उदाहरण के API को एन 8 एन नोड या HTTP Request नोड के माध्यम से बुला सकते हैं। क्योंकि प्रत्येक आइटम के लिए एक नोड एक बार चलता है, 1,000 वस्तुओं की सूची थोड़े समय में लगभग 1,000 अनुरोध बना सकती है।
प्रति-कुंजी नियंत्रण के बिना, एक व्यस्त वर्कफ़्लो उदाहरण पर सभी को प्रभावित कर सकता है। कुछ ग्राहक उस जोखिम को कम करने के लिए n8n के आसपास अपने स्वयं के दर सीमितकर्ता का निर्माण कर रहे थे। नई सीमाओं ने उस सुरक्षा को एन 8 एन के भीतर रखा। प्रत्येक टीम निर्माण जारी रख सकती है, जबकि जब एक कार्यप्रवाह भाग जाता है तो उदाहरण के अभिभूत होने की संभावना कम होती है।
कैसे व्यवस्थापक सीमाओं को कॉन्फ़िगर और सक्षम कर सकते हैं
दर सीमाएं प्रत्येक API कुंजी से यातायात पर एक छत निर्धारित करती हैं। जो क्लाइंट बहुत अधिक ट्रैफ़िक भेजता है, वह अन्य कुंजियों को अवरुद्ध करने के बजाय अपनी सीमा तक पहुंच जाता है। व्यवस्थापक तय करते हैं कि कौन सा ट्रैफिक स्वीकार्य है, पढ़ने और लिखने के लिए अलग-अलग सीमाओं के साथ। वे सीमाएँ सभी एंडपॉइंट्स या प्रति एंडप्वाइंट पर लागू हो सकती हैं, जिससे रीड की तुलना में लेखन के लिए एक तंग छत सेट करना संभव होता है। Each API कुंजी उन नियमों के भीतर अपनी गणना रखती है।
जब कोई कुंजी एक सीमा तक पहुँचती है, तो n8n 429 प्रतिक्रिया के साथ उत्तर देता है। उस प्रतिक्रिया में Retry-After और दर-सीमा हेडर शामिल होते हैं, इसलिए क्लाइंट देख सकते हैं कि कब पुनः प्रयास करना है और कितने अनुरोध बचे हैं। सीमाएं डिफ़ॉल्ट मानों से शुरू होती हैं, और सेटिंग्स पृष्ठ या API के माध्यम से किए गए परिवर्तन तुरंत पुनरारंभ के बिना लागू होते हैं। बहु-मुख्य सेटअप में, प्रत्येक मुख्य Redis द्वारा API कुंजी पर एक गणना साझा करता है, इसलिए जो कुंजी अपनी सीमा तक पहुंच जाती है वह विंडो समाप्त होने तक हर प्रमुख से 429 प्राप्त करती है।
दर की सीमा डिफ़ॉल्ट रूप से बंद है. व्यवस्थापक इसे तीन तरीकों से सक्षम कर सकते हैं, यह इस बात पर निर्भर करता है कि वे n8n कैसे चलाते हैं. सेटिंग पृष्ठ में, सेटिंग्स पर जाएं > नीतियां > Public API Limits, Enable API कुंजी दर सीमा को चालू करें, सीमा और विंडो समायोजित करें, और सीमाएँ सक्षम करें चुनें. सार्वजनिक API के माध्यम से, वर्तमान सेटिंग्स पढ़ने के लिए GET / API /v1/settings/rate-limits का उपयोग करें और उन्हें बदलने के लिए PUT / Redis 07 / v1,001. इन अनुरोधों के लिए प्रयुक्त कीज को securitySettings: manage scope की आवश्यकता होती है। स्व-होस्ट किए गए उदाहरणों पर, N8N_PUBLIC_ API _RATE_LIMIT_ENABLED को true सेट करें और n8n पुनः आरंभ करें, फिर व्यक्तिगत सीमाओं और खिड़कियों को परिवर्तित करने के लिए एन 8एन_पुब्लिक_ Redis 7 _रेट_लिमिट_* चर का प्रयोग करें. एक पर्यावरण चर सेटिंग या पृष्ठ API, और सेटिंग पेज द्वारा बनाई गई सेटिंग्स को ओवरराइड करता है जब तक कि फ़ील्ड प्रभावित नहीं होता तब तक वेरिएबल लॉक किया जाता है और बदलता रहता है।
कैसे क्लाइंट और कार्यप्रवाह सीमाओं के अंतर्गत रहते हैं
API क्लाइंट्स रेट-लिमिट हेडर्स का उपयोग छतों को हिट करने से बचने के लिए कर सकते हैं। चार आदतें उन्हें सीमाओं के भीतर रहने में मदद करती हैंः पुनः प्रयास करने से पहले पुनरावृत्ति में सेकंड की संख्या की प्रतीक्षा करें; 5 सेकंड तक की एक छोटी यादृच्छिक देरी जोड़ें ताकि विभिन्न ग्राहकों से पुनरावृत्तियां फैल जाएं; X-RateLimit-Remaining देखें और धीमा हो जाए क्योंकि यह 0 तक पहुंचता है जब तक कि एक्स-रेट लिमिट-रीसेट में समय नहीं होता; और खिड़की भर में स्थिर दर पर अनुरोध भेजकर बड़े कार्यों को फैलाएं।
कार्यप्रवाह जो अपने स्वयं के उदाहरण API को कॉल करते हैं, उन्हें एक अतिरिक्त चरण की आवश्यकता होती है। n8n नोड और HTTP Request नोड प्रति आइटम एक अनुरोध भेजते हैं और 429 पर विफल हो जाते हैं, इसलिए एक बड़ी सूची जल्दी से सीमा तक पहुंच सकती है।
केवल अनुरोध जो / API / v1 पर एक API कुंजी का उपयोग करते हैं, सीमाओं की ओर गिनती करते हैं। n8n संपादक के अनुरोधों को नहीं गिना जाता है। Each API कुंजी की अपनी गणना होती है, लेकिन प्रत्येक कुंजी समान सीमाओं के भीतर काम करती है। एक एकीकरण अधिक हेडरूम देने के लिए, इसे अलग-अलग एन 8 एन उदाहरण पर चलाएं। जब अनुरोध प्रगति में होते हैं तो एक सीमा बदलते समय नई सीमा तुरंत लागू होती है; यदि नई सीमा एक API कुंजियों की वर्तमान संख्या से कम है, तो उस कुंजी के अगले अनुरोध को 429 मिलता है, और विंडो समाप्त होने पर गणना रीसेट हो जाती है।
एक प्रकार की सीमा को बंद करने के लिए, उस सीमा को 0 पर सेट करें. पढ़ने या लिखने को वैश्विक रूप से या प्रति समापन बिंदु अक्षम किया जा सकता है जबकि अन्य सीमाएँ सक्रिय रहती हैं। जब दर सीमित करना सक्षम होता है, तो कम से कम एक सीमा 0 से अधिक होनी चाहिए।
क्यों idempotency कुंजियाँ मायने रखती हैं
दर सीमा का मतलब है कि क्लाइंट कभी-कभी 429 प्राप्त कर सकते हैं और फिर से प्रयास करने की आवश्यकता हो सकती है। एक POST अनुरोध को पुनः पेश करना जोखिम उठाता हैः यदि पहला अनुरोध पहले ही सफल हो गया था, तो पुनरावृत्ति दोहराव बना सकता है। Idempotency कुंजी उन पुनरावृत्तियों को सुरक्षित बनाती है, इसलिए ग्राहक 429 के बाद वापस आकर आत्मविश्वास के साथ फिर से कोशिश कर सकते हैंः
सार्वजनिक API POST अनुरोध के साथ एक Idempotency-Key हेडर भेजें. यदि अनुरोध सफल होता है, तो n8n 12 घंटों के लिए प्रतिक्रिया संग्रहीत करता है, और उसी कुंजी और शरीर के साथ पुनः प्रयास POST को फिर से चलाने के बजाय उस संग्रहित प्रतिक्रिया को प्राप्त करता है। अगर पहला अनुरोध विफल हो जाता है, एन 8एन कुंजी जारी कर देता है, इसलिए पुनरावृत्ति सामान्य रूप से चलता है। API idempotence प्रलेखन में प्रमुख प्रारूप और विरोधाभासी या प्रगतिशील अनुरोधों की प्रतिक्रियाएं शामिल हैं।
आगे क्या करना है
n8n 2.47.0 या बाद में अद्यतन, सेटिंग्स में दर सीमा चालू करें > नीतियां > Public API Limits, और पूर्ण विन्यास संदर्भ के लिए API दर सीमा प्रलेखन की जाँच करें। यदि क्लाइंट POST अनुरोध भेजते हैं, तो एक ही समय में idempotency कुंजियों को जोड़ें
विशेष रुप से प्रदर्शित छवि: अमूर्त दोस्ताना चित्रण n8n वर्कफ़्लो नोड्स, API कुंजियों और दर-सीमा डायल दिखा रहा है, जिसमें कोई लोग, लोगो या पाठ नहीं हैं।

Comments (0)