सरल इंटरफ़ेस कॉल से लेकर जटिल सिस्टम एकीकरण तक, धीरे-धीरे विकास क्षमताओं में सुधार करें
7 दिनों में एपीआई विकास और सिस्टम एकीकरण के मुख्य कौशल में महारत हासिल करें
जटिल व्यवसाय अनुकूलन विकास को साकार करने के लिए 7 दिनों में मास्टर एपीआई विकास और सिस्टम एकीकरण
स्वतंत्र रूप से पूरा करने में सक्षमएपीआई कॉल, डेटा सिंक्रनाइज़ेशन, सिस्टम एकीकरण, जटिल व्यवसाय अनुकूलन विकासविकास कार्यों का इंतजार है
अनुमानित अध्ययन समय: 4-6 घंटे
सीखने के संसाधन: त्वरित शुरुआत | प्रमाणीकरण विधि
अनुमानित अध्ययन समय: 6-8 घंटे
💡 टिप्स: डिबगिंग दक्षता में सुधार के लिए आमतौर पर उपयोग किए जाने वाले इंटरफेस को सहेजने के लिए पोस्टमैन कलेक्शन का उपयोग करें
अनुमानित अध्ययन समय: 6-8 घंटे
कोड उदाहरण: वेबहुक कोड उदाहरण | डेटा सिंक्रनाइज़ेशन समाधान
अनुमानित अध्ययन समय: 4-6 घंटे
🏆 अनुशंसित व्यायाम: एक पूर्ण एकीकरण समाधान बनाएं (जियानदाओ क्लाउड ↔ ईआरपी सिस्टम डेटा सिंक्रनाइज़ेशन)
बुनियादी दस्तावेज
खुले मंच की समग्र वास्तुकला और उपयोग निर्देश
→ खुला मंच देखेंपूर्ण एपीआई संदर्भ
सभी एपीआई इंटरफेस का विस्तृत विवरण और उदाहरण
→ एपीआई दस्तावेज़ देखेंप्रमाणीकरण कॉन्फ़िगरेशन
एपीआई कुंजी पीढ़ी और प्रमाणीकरण कॉन्फ़िगरेशन विधि
→ प्रमाणीकरण कॉन्फ़िगरेशन जानेंडिबगिंग उपकरण
ऑनलाइन डिबगिंग प्लेटफ़ॉर्म उपयोग के तरीके और तकनीकें
→ डिबग बेंच का उपयोग करेंत्रुटि प्रबंधन
एपीआई त्रुटि कोड विवरण और समाधान
→ त्रुटि कोड देखेंसभी विकास दस्तावेज
खुले मंच के सभी दस्तावेज़ों और संसाधनों का सारांश
→ खुले मंच तक पहुंचेंकोड उदाहरण
पायथन/जावा/गो एपीआई कॉल नमूना कोड
→ कोड उदाहरण देखेंघटना सुनना
वेबहुक कॉन्फ़िगरेशन और इवेंट मॉनिटरिंग पर संपूर्ण ट्यूटोरियल
→ वेबहुक सीखेंउन्नत विशेषताएँ
एकत्रीकरण तालिका, स्मार्ट सहायक प्रो और अन्य उन्नत कार्यात्मक एपीआई
→ उन्नत एपीआई देखेंउद्योग और वित्तीय एकीकरण को प्राप्त करने के लिए चार प्रमुख प्रणालियों को खोलें, और वेबहुक + एपीआई के माध्यम से स्वचालित डेटा सिंक्रनाइज़ेशन और प्रक्रिया लिंकेज का एहसास करें
ईआरपी, सीआरएम, वित्त और अन्य मल्टी-सिस्टम एकीकरण समाधानों सहित विभिन्न उद्योगों में सफल सिस्टम एकीकरण मामलों का सारांश
तीन सामान्य परिदृश्यों के लिए कोड उदाहरण, कॉपी करें और तुरंत उपयोग करें
आयात अनुरोध
json आयात करें
# कॉन्फ़िगरेशन जानकारी
API_KEY = "your_api_key_here" # अपनी API कुंजी से बदलें
APP_ID = "your_app_id" # Application ID
ENTRY_ID = "आपकी_entry_id" # फॉर्म आईडी
# एपीआई समापन बिंदु
यूआरएल = एफ"https://www.jiandaoyun.com/api/v1/app/{APP_ID}/entry/{ENTRY_ID}/create"
# अनुरोध हेडर (बियरर टोकन प्रमाणीकरण)
हेडर = {
"प्राधिकरण": f"वाहक {API_KEY}",
"सामग्री-प्रकार": "एप्लिकेशन/जेसन"
}
#डेटा सबमिट किया जाना है
पेलोड = {
"डेटा": {
"_विजेट_12346789": {"ग्राहक का नाम": "अलीबाबा"}, # पाठ की एकल पंक्ति
"_विजेट_12346789": {"फ़ोन": "138013800"}, # फ़ोन फ़ील्ड
"_विजेट_12346789": {"पता": "युहांग जिला, हांग्जो शहर"} # पता
}
}
# अनुरोध भेजें
प्रतिक्रिया = अनुरोध.पोस्ट (यूआरएल, हेडर = हेडर, जेसन = पेलोड)
# प्रतिक्रिया संसाधित करें
यदि प्रतिक्रिया.status_code == 200:
परिणाम = प्रतिक्रिया.json()
प्रिंट करें ("✅ डेटा सफलतापूर्वक बनाया गया!")
प्रिंट(f"डेटा आईडी: {परिणाम['डेटा']['_आईडी']}")
अन्य:
प्रिंट(f"❌ त्रुटि: {response.status_code} - {response.text}")
🔑प्रमाणीकरण विधि
बियरर टोकन (हेडर में एपीआई कुंजी पास करें)
📊 फ़ील्ड प्रारूप
_विजेट_आईडी: {"फ़ील्ड नाम": "मान"}
✅ परिणाम लौटाएँ
200 ओके + डेटा आईडी
स्थिरांक axios = आवश्यकता('axios');
//कॉन्फ़िगरेशन जानकारी
स्थिरांक API_KEY = 'your_api_key_here'; // अपनी एपीआई कुंजी से बदलें
const APP_ID = 'your_app_id'; // एप्लिकेशन आईडी
स्थिरांक ENTRY_ID = 'आपकी_entry_id'; // फॉर्म आईडी
// एपीआई समापन बिंदु
स्थिरांक यूआरएल = `https://www.jiandaoyun.com/api/v1/app/${APP_ID}/entry/${ENTRY_ID}/retrieve`;
// हेडर अनुरोध करें
स्थिरांक शीर्षलेख = {
'प्राधिकरण': `वाहक ${API_KEY}`,
'सामग्री-प्रकार': 'एप्लिकेशन/जेसन'
};
// क्वेरी शर्तें: सभी डेटा ढूंढें जिनकी "अनुमोदन स्थिति" "लंबित अनुमोदन" है
स्थिरांक पेलोड = {
"फ़िल्टर": {
"rel": "और", // सशर्त संबंध: और/या
"शर्त": [
{
"फ़ील्ड": "_विजेट_12346789", // अनुमोदन स्थिति फ़ील्ड आईडी
"विधि": "eq", // eq (बराबर), ne (बराबर नहीं), lt (इससे कम), gt (इससे अधिक)
"मूल्य": "लंबित अनुमोदन"
}
]
},
"सीमा": 100, // हर बार 100 आइटम तक लौटें
"फ़ील्ड": [ // लौटाए जाने वाले फ़ील्ड
"_विजेट_12346789", // ग्राहक का नाम
"_विजेट_12346789" // अनुमोदन स्थिति
]
};
// अनुरोध भेजें
axios.post(यूआरएल, पेलोड, { हेडर })
.तब(प्रतिक्रिया => {
कंसोल.लॉग('✅ क्वेरी सफल!');
कंसोल.लॉग(`डेटा के ${response.data.data.length} टुकड़े मिले`);
प्रतिक्रिया.डेटा.डेटा.forEach((आइटम, सूचकांक) => {
कंसोल.लॉग(`${index + 1}. ${item._widget_12346789} - ${item._widget_12346789}`);
});
})
.पकड़(त्रुटि => {
कंसोल.त्रुटि('❌ त्रुटि:', त्रुटि.प्रतिक्रिया ? त्रुटि.प्रतिक्रिया.डेटा : त्रुटि.संदेश);
});
🔍 प्रश्न शर्तें
फ़िल्टर.कंड सरणी (समर्थन और/या)
📦 पेजिंग क्वेरी
पेजिंग लागू करने के लिए सीमा + छोड़ें
🎯फ़ील्ड फ़िल्टरिंग
फ़ील्ड्स रिटर्न फ़ील्ड निर्दिष्ट करता है
फ्लास्क से आयात फ्लास्क, अनुरोध, jsonify
एचएमएसी आयात करें
हैशलिब आयात करें
json आयात करें
ऐप = फ्लास्क(__नाम__)
# वेबहुक साइनिंग कुंजी (जियानदाओ क्लाउड बैकएंड में कॉन्फ़िगर किया गया)
WEBHOOK_SECRET = "आपका_webhook_secret"
@app.route('/webhook/jiandaoyun', मेथड्स=['POST'])
डीईएफ़ हैंडल_वेबहुक():
# 1. हस्ताक्षर सत्यापित करें (महत्वपूर्ण!)
हस्ताक्षर = request.headers.get('X-JDY-हस्ताक्षर')
टाइमस्टैम्प = request.headers.get('X-JDY-टाइमस्टैम्प')
बॉडी = request.get_data(as_text=True)
# हस्ताक्षर की गणना करें
साइन_स्ट्र = एफ"{टाइमस्टैम्प}.{बॉडी}"
अपेक्षित_हस्ताक्षर = hmac.new(
WEBHOOK_SECRET.encode(),
साइन_स्ट्र.एनकोड(),
hashlib.sha256
).हेक्सडाइजेस्ट()
यदि हस्ताक्षर != अपेक्षित_हस्ताक्षर:
वापसी jsonify({"त्रुटि": "अमान्य हस्ताक्षर"}), 403
# 2. ईवेंट डेटा पार्स करें
इवेंट_डेटा = json.loads(बॉडी)
इवेंट_प्रकार = इवेंट_डेटा.गेट('ऑप') # डेटा_क्रिएट / डेटा_अपडेट / फ़्लो_अप्रूव
ऐप_आईडी = इवेंट_डेटा.गेट('एपआईडी')
प्रविष्टि_आईडी = इवेंट_डेटा.गेट('एंट्रीआईडी')
डेटा = इवेंट_डेटा.गेट('डेटा') # फॉर्म डेटा
print(f"✅ प्राप्त वेबहुक ईवेंट: {event_type}")
प्रिंट(f"फॉर्म आईडी: {entry_id}")
प्रिंट(f"डेटा: {डेटा}")
#3. घटना प्रकार के अनुसार प्रक्रिया
यदि इवेंट_प्रकार == 'डेटा_क्रिएट':
# नए डेटा निर्माण की घटनाओं को संभालें
ग्राहक_नाम = data.get('_widget_12346789', {})
प्रिंट करें(f"नया ग्राहक: {ग्राहक_नाम}")
# कार्य: अपने सीआरएम सिस्टम से सिंक करें
एलिफ इवेंट_टाइप == 'फ्लो_अप्रूव':
# अनुमोदन घटनाओं को संभालें
स्वीकृत_परिणाम = इवेंट_डेटा.गेट('परिणाम') # सहमत/अस्वीकार
प्रिंट करें (f"अनुमोदन परिणाम: {approve_result}")
# कार्य: अनुमोदन परिणामों की प्रणाली को सूचित करें
#4. रसीद की पुष्टि के लिए 200 लौटाएं (आवश्यक!)
वापसी jsonify({"स्थिति": "सफलता"}), 200
यदि __नाम__ == '__मुख्य__':
ऐप.रन(होस्ट='0.0.0.0', पोर्ट=5000)
🔐हस्ताक्षर सत्यापन
HMAC-SHA256 जालसाजी विरोधी
📡घटना का प्रकार
data_create/update/delete, flow_approve
✅ अनुरोधों का जवाब दें
200 स्टेटस कोड लौटाना होगा
1️⃣ एपीआई कुंजी प्राप्त करें
2️⃣ फ़ील्ड आईडी प्राप्त करें
3️⃣ डिबगिंग सुझाव
4️⃣ सुरक्षा अनुशंसाएँ
सरल इंटरफ़ेस कॉल से लेकर जटिल सिस्टम एकीकरण तक, धीरे-धीरे विकास क्षमताओं में सुधार करें
© 2015-2035 शंघाई सियांग सूचना प्रौद्योगिकी कंपनी लिमिटेड | शंघाई आईसीपी नंबर 1600722-8