GanttFather API टोकन बनाएं, v1 REST API को सुरक्षित रूप से कॉल करें, कोटा और निष्क्रियता को संभालें, और REST और MCP के बीच चयन करें।
GanttFather REST API स्क्रिप्ट और एकीकरण के लिए संस्करणित प्रोजेक्ट, कार्य, निर्भरता, सदस्य और संसाधन संचालन को उजागर करता है। GanttFather टोकन के साथ प्रमाणित करें, एक गैर-रिक्त उपयोगकर्ता-एजेंट हेडर भेजें, रीड कॉल से शुरू करें, और एक कार्य या संसाधन बनाते समय एक Idempotency-कुंजी का उपयोग करें जिसे पुनः प्रयास किया जा सकता है।
API व्यवहार 7 अगस्त, 2026 को सत्यापित किया गया। इसका इलाज करें लाइव API संदर्भ समापन बिंदु-स्तरीय अनुबंध के रूप में।
आप GanttFather API के साथ क्या स्वचालित कर सकते हैं?
v1 API सामान्य शेड्यूल-एकीकरण वर्कफ़्लो का समर्थन करता है:
- सुलभ परियोजनाओं की सूची बनाएं और एक परियोजना का निरीक्षण करें
- कार्यों, सदस्यों, संसाधनों और निर्भरताओं को सूचीबद्ध करें और पढ़ें
- कार्य बनाएं, आंशिक रूप से अपडेट करें, पुन: व्यवस्थित करें और हटाएं
- कार्य निर्भरताएँ जोड़ें या हटाएँ
- संसाधन बनाएं, अपडेट करें और हटाएं
- बाहरी रिकॉर्ड और GanttFather आईडी के बीच अपनी खुद की मैपिंग संलग्न करें
सार्वजनिक API ब्राउज़र की आंतरिक API जैसी सतह नहीं है। केवल प्रलेखित v1 समापन बिंदु और प्रतिक्रिया फ़ील्ड का उपयोग करें।
आप API टोकन कैसे बनाते और उपयोग करते हैं?
GanttFather खोलें, सेटिंग्स → AI एजेंट्स और API पर जाएं, और सबसे छोटे उपयोगी दायरे और अनुमति के साथ एक टोकन बनाएं। जब कच्चा टोकन दिखाया जाए तो उसे कॉपी करें और उसे एक गुप्त प्रबंधक में संग्रहीत करें; GanttFather बाद में प्रदर्शित करने के लिए मूल मान संग्रहीत नहीं करता है।
फिर इस क्रम का पालन करें:
- पढ़ें प्रमाणीकरण मार्गदर्शिका.
- बुलाओ परियोजनाओं की सूची बनाएं एक सुलभ प्रोजेक्ट आईडी खोजने के लिए।
- लिखने का प्रयास करने से पहले कार्यों को पढ़ें।
- एक डिस्पोजेबल परीक्षण कार्य बनाएं।
- बल्क जॉब से पहले पेजिनेशन, पुनः प्रयास और कोटा हैंडलिंग जोड़ें।
प्रत्येक अनुरोध में बियरर टोकन और एक गैर-रिक्त उपयोगकर्ता-एजेंट शामिल होना चाहिए जो ग्राहक की पहचान करता है। एक लापता उपयोगकर्ता-एजेंट को सामान्य समापन बिंदु प्रबंधन से पहले अस्वीकार कर दिया जाता है।
लिखने के लिए कौन से सुरक्षा नियम मायने रखते हैं?
केवल आपके एकीकरण के स्वामित्व वाले फ़ील्ड के लिए आंशिक अपडेट का उपयोग करें। इसे बदलने से पहले वर्तमान स्थिति को पढ़ें, स्थिर आईडी लॉग करें और जानकारी का पता लगाएं, और प्रत्येक बाहरी फ़ील्ड को बिना शर्त ओवरराइट में न बदलें।
कार्य और संसाधन निर्माण के लिए, एक इडेम्पोटेंसी-कुंजी भेजें जब टाइमआउट या नेटवर्क विफलता के कारण पुनः प्रयास करना पड़ सकता है। उसी अनुरोध के साथ कुंजी का पुन: उपयोग करने से पिछला परिणाम वापस आ जाता है; किसी भिन्न अनुरोध के साथ इसका पुन: उपयोग करना एक विरोध है। अपडेट और डिलीट के अपने दस्तावेजी शब्दार्थ होते हैं और वे उस क्रिएट-ओनली कुंजी को सार्वभौमिक डिडुप्लीकेशन तंत्र के रूप में स्वीकार नहीं करते हैं।
निर्भरताएँ और पदानुक्रम अलग-अलग चिंताएँ हैं। पुन: क्रमित करना पैरेंट प्लेसमेंट को बदलने का स्वीकृत तरीका है; निर्भरता समापन बिंदु मॉडल पूर्ववर्ती संबंध। एक को दूसरे से प्राप्त करने के बजाय दोनों को मान्य करें।
दर और दैनिक कोटा सीमाएँ क्या हैं?
डिफ़ॉल्ट सुरक्षा 60 अनुरोध प्रति मिनट प्रति प्रमाणित टोकन और 5,000 अनुरोध प्रति दिन प्रति टोकन है। एक सीमित प्रतिक्रिया HTTP 429 का उपयोग करती है और पुनः प्रयास की जानकारी प्रदान करती है। वर्तमान की जाँच करें दर सीमा और कोटा दस्तावेज़ीकरण उत्पादन कार्यभार की योजना बनाने से पहले क्योंकि परिचालन सीमाएँ बदल सकती हैं।
सही ढंग से पेजिनेट करके, बैचों में पढ़कर, स्थिर आईडी को कैशिंग करके और प्रति-फ़ील्ड अपडेट के अनुक्रम के बजाय एक आंशिक अपडेट भेजकर अनुरोध मात्रा कम करें। एक रिट्री लूप को रिट्री-आफ्टर का सम्मान करना चाहिए और जिटर के साथ बाउंडेड एक्सपोनेंशियल बैकऑफ़ का उपयोग करना चाहिए।
आपको MCP के स्थान पर REST का उपयोग कब करना चाहिए?
REST का उपयोग करें जब नियतात्मक एप्लिकेशन कोड को संस्करणित HTTP संसाधनों, स्पष्ट त्रुटि प्रतिक्रियाओं और नियंत्रित पुनः प्रयास व्यवहार की आवश्यकता होती है। का प्रयोग करें MCP सर्वर जब Claude जैसे AI क्लाइंट को Model Context Protocol के माध्यम से उच्च-स्तरीय प्रोजेक्ट टूल को लागू करना चाहिए।
दोनों GanttFather के टोकन लेन का उपयोग कर सकते हैं, लेकिन उनके संचालन और निष्क्रियता इनपुट विनिमेय नहीं हैं। API एकीकरण को REST संदर्भ का पालन करना चाहिए; एक एजेंट को MCP टूल विवरण का पालन करना चाहिए।
सुरक्षित प्रथम एकीकरण पैटर्न क्या है?
प्रत्येक फ़ील्ड के लिए एक दिशा और एक स्वामी से प्रारंभ करें:
| कदम | अनुशंसित व्यवहार |
|---|---|
| खोजें | परियोजनाओं की सूची बनाएं और चयनित प्रोजेक्ट आईडी रिकॉर्ड करें |
| पढ़ें | मौजूदा कार्यों को पेज करें और एक आईडी मैप बनाएं |
| तुलना करें | बिना लिखे परिवर्तन सेट की गणना करें |
| समीक्षा | लॉग इच्छित बनाता है, अद्यतन करता है, और हटाता है |
| लिखो | सबसे छोटा समर्थित उत्परिवर्तन लागू करें |
| सत्यापित करें | परिणाम पढ़ें और लौटाई गई आईडी रिकॉर्ड करें |
जब तक विरोध स्वामित्व, विलोपन नियम, पुनः प्रयास और पुनर्प्राप्ति परिभाषित नहीं हो जाती, तब तक “सिंक” का दावा न करें।
आपको GanttFather API पर कब निर्माण करना चाहिए?
API का उपयोग तब करें जब किसी फॉर्म, परिनियोजन पाइपलाइन, ग्राहक पोर्टल, या आंतरिक सिस्टम को उसी प्रोजेक्ट डेटा तक दोहराए जाने योग्य पहुंच की आवश्यकता हो जिसे आपकी टीम GanttFather में देखती है। सबसे विश्वसनीय पहला उपयोग मामला संकीर्ण है - उदाहरण के लिए, तैनाती के बाद एक रिलीज मील का पत्थर बनाएं - फिर वास्तविक विफलताओं और पुनः प्रयास को देखने के बाद विस्तार करें।
API यह तय नहीं करता है कि कौन सा सिस्टम किसी फ़ील्ड का मालिक है या मल्टी-सिस्टम वर्कफ़्लो को संघर्ष-मुक्त बनाता है। आपके एकीकरण को उन नियमों को परिभाषित करना होगा।
GanttFather प्रोजेक्ट बनाएं, न्यूनतम-विशेषाधिकार टोकन जारी करें, और उत्पादन रिकॉर्ड कनेक्ट करने से पहले डिस्पोजेबल डेटा के विरुद्ध परीक्षण करें।
अक्सर पूछे जाने वाले प्रश्न
क्या API एक्सेस निःशुल्क स्तर पर शामिल है?
API एक्सेस वर्तमान में GanttFather योजनाओं में उपलब्ध है। क्षमता और सुरक्षा सीमाएँ अभी भी लागू हैं; सत्यापित करें मूल्य निर्धारण पृष्ठ और वर्तमान शर्तों के लिए API कोटा दस्तावेज़ीकरण।
GanttFather API टोकन कैसा दिखता है?
टोकन GanttFather टोकन प्रारूप का उपयोग करते हैं और बियरर क्रेडेंशियल के रूप में प्रस्तुत किए जाते हैं। स्रोत नियंत्रण के लिए कभी भी कोई टोकन न भेजें या इसे सार्वजनिक लॉग में शामिल न करें।
क्या उपयोगकर्ता-एजेंट वैकल्पिक है?
सामान्य v1 अनुरोधों के लिए नहीं। एक गैर-रिक्त मान भेजें जो आपके एकीकरण की पहचान करता है, जैसे उत्पाद का नाम और संस्करण।
क्या प्रत्येक अनुरोध में एक इडेम्पोटेंसी-कुंजी शामिल होनी चाहिए?
नहीं, जब उसी अनुरोध को पुनः प्रयास किया जा सकता है तो दस्तावेज़ीकृत निर्माण कार्यों के लिए इसका उपयोग करें। यह एक सामान्य प्रयोजन संस्करण या समवर्ती शीर्षलेख नहीं है।
क्या API Azure DevOps एकीकरण स्रोतों को कॉन्फ़िगर कर सकता है?
सार्वजनिक v1 प्रोजेक्ट-डेटा API और उत्पाद का Azure DevOps एकीकरण अलग-अलग सतहें हैं। यह न मानें कि एक अप्रलेखित एकीकरण समापन बिंदु मौजूद है।
OpenAPI दस्तावेज़ कहाँ है?
से शुरू करें GanttFather API परिचय और प्रमाणीकरण, समापन बिंदु, स्कीमा और त्रुटियों के लिए संदर्भ लिंक का पालन करें।
