आपकी उत्पाद टीम को इस सप्ताह एक कार्यशील YouTube डाउनलोडर की आवश्यकता है, और आपको इसे अपने बैकएंड में वायर करने से पहले Postman में अंत से अंत तक सत्यापित करने की आवश्यकता है। इस गाइड के अंत तक, आप Zyla API Hub के साथ प्रमाणीकरण करने में सक्षम होंगे, Postman में YouTube डाउनलोड और जानकारी API के डाउनलोड एंडपॉइंट को हिट करेंगे, और प्रोग्रामेटिक रूप से जॉब आईडी और थंबनेल URL प्राप्त करेंगे जिसका उपयोग आप अपने उपयोगकर्ताओं को प्रगति को ट्रैक और प्रस्तुत करने के लिए कर सकते हैं।
YouTube डाउनलोड और जानकारी API क्या करता है
YouTube डाउनलोड और जानकारी API नियमित YouTube वीडियो के लिए विशिष्ट प्रारूपों (वीडियो रिज़ॉल्यूशन या ऑडियो प्रारूप) में डाउनलोड शुरू करने के लिए एक सरल HTTP एंडपॉइंट प्रदान करता है और एक अद्वितीय डाउनलोड जॉब आईडी, वीडियो की थंबनेल छवि URL, और एक प्रगति URL के साथ एक छोटा JSON लौटाता है। इसका सामान्य उपयोग होता है:
- सर्वर-साइड कार्यकर्ता जो एक रूपांतरण को कतारबद्ध करते हैं और प्रगति के लिए पोल करते हैं।
- बैकेंड-फॉर-फ्रंटेंड सेवाएँ जो UI अपडेट के लिए ग्राहकों को एक जॉब आईडी लौटाती हैं।
- आंतरिक उपकरण जिन्हें एक विशिष्ट प्रारूप में एक प्ले करने योग्य फ़ाइल लाने का तेज़ तरीका चाहिए।
आपके कार्यान्वयन में योजना बनाने के लिए नोट्स:
- ऑडियो डाउनलोड लिंक 2 घंटे बाद समाप्त हो जाते हैं।
- यह एंडपॉइंट केवल नियमित वीडियो डाउनलोड का समर्थन करता है।
Zyla API Hub पर शुरुआत करना
Zyla API Hub पर YouTube डाउनलोड और जानकारी API पृष्ठ खोलें: YouTube डाउनलोड और जानकारी API। सब्सक्राइब पर क्लिक करें (या उपलब्ध होने पर फ्री ट्रायल शुरू करें), फिर एक API कुंजी उत्पन्न करें। बिलिंग सब्सक्रिप्शन + कोटा है (पे-पर-कॉल नहीं)। Zyla पर पहला API आमतौर पर 7-दिन का ट्रायल या 50 अनुरोध प्रदान करता है; कोई मुफ्त योजना नहीं है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
यदि आपके पास अभी तक खाता नहीं है, तो यहाँ एक बनाएं: पंजीकरण करें। आप कभी भी Zyla API Hub पर अन्य श्रेणियों और APIs का अन्वेषण कर सकते हैं।
एंडपॉइंट जिसे आप Postman में परीक्षण करेंगे
API एक एकल डाउनलोड करने योग्य ट्रिगर एंडपॉइंट को उजागर करता है जिसे आप वीडियो URL और इच्छित प्रारूप के साथ सक्रिय कर सकते हैं।
डाउनलोड (GET)
- विधि: GET
- URL: https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download
- प्रमाणन: बियरर टोकन के साथ प्रमाणीकरण हेडर
- आवश्यक क्वेरी पैरामीटर:
- url (string): YouTube वीडियो URL। उदाहरण: https://www.youtube.com/watch?v=aGSKrC7dGcY
- format (string): इच्छित आउटपुट प्रारूप।
फॉर्मेट पैरामीटर के लिए स्वीकार्य मान:
- वीडियो: 360p, 480p, 720p, 1080p, 1440p, 2160p
- ऑडियो: mp3, m4a, flac, opus, wav
नोट्स:
- ऑडियो डाउनलोड लिंक 2 घंटे बाद समाप्त हो जाते हैं।
- यह एंडपॉइंट केवल नियमित वीडियो डाउनलोड का समर्थन करता है।
Postman: चरण-दर-चरण
1) एक नया अनुरोध बनाएं
Postman में, New → HTTP Request पर क्लिक करें। विधि को GET पर सेट करें।
2) अनुरोध URL सेट करें
क्वेरी पैरामीटर के साथ पूर्ण एंडपॉइंट पेस्ट करें (आप या तो एन्कोडेड फॉर्म पेस्ट कर सकते हैं या Params टैब का उपयोग कर सकते हैं):
https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DaGSKrC7dGcY&format=720
यदि Postman में Params UI का उपयोग कर रहे हैं, तो जोड़ें:
- कुंजी:
url| मान:https://www.youtube.com/watch?v=aGSKrC7dGcY - कुंजी:
format| मान:720
3) प्रमाणीकरण हेडर जोड़ें
हेडर्स के तहत, जोड़ें:
- कुंजी:
Authorization - मान:
Bearer YOUR_API_KEY
YOUR_API_KEY को अपने Zyla खाते की कुंजी से बदलें।
4) भेजें और प्रतिक्रिया की जांच करें
Send पर क्लिक करें। आपको एक JSON पेलोड प्राप्त होना चाहिए जिसमें फ़ील्ड हों जिन्हें आप जॉब को ट्रैक करने और उपयोगकर्ता को एक पूर्वावलोकन छवि दिखाने के लिए उपयोग कर सकते हैं।
आधिकारिक cURL जिसे आप Postman में आयात कर सकते हैं
आप इस सटीक cURL को Postman में भी आयात कर सकते हैं (File → Import → Raw text) ताकि एक पूर्व भरे हुए अनुरोध को प्राप्त किया जा सके:
curl -s -X GET "https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DaGSKrC7dGcY&format=720"
-H "Authorization: Bearer YOUR_API_KEY"नमूना JSON प्रतिक्रिया
{
"success": true,
"id": "2ec15939807689549d3f3115f168be6b9c868105",
"image": "https://i.ytimg.com/vi/aGSKrC7dGcY/hqdefault.jpg",
"progress_url": "https://youtube-api-progress-copy-development.up.railway.app/api/progress?id=2ec15939807689549d3f3115f168be6b9c868105"
}आप वास्तव में जिन फ़ील्डों का उपयोग करेंगे, उनके अर्थ:
- success: Boolean जो इंगित करता है कि अनुरोध स्वीकार किया गया था।
- id: प्रारंभ किए गए डाउनलोड के लिए अद्वितीय जॉब पहचानकर्ता।
- image: एक थंबनेल URL (जब डाउनलोड प्रगति में हो तब आपके UI के लिए उपयोगी)।
- progress_url: एक URL जिसका उपयोग आप अपनी ओर से जॉब की प्रगति को ट्रैक करने के लिए कर सकते हैं।
कोड उदाहरण: JavaScript (Node.js)
यह Node.js उदाहरण उसी एंडपॉइंट को कॉल करता है, JSON को पार्स करता है, और उन फ़ील्डों को लॉग करता है जिन्हें आप अपने जॉब ट्रैकिंग और UI कोड में वायर करेंगे। यह केवल प्रलेखित URL और पैरामीटर का उपयोग करता है।
import fetch from "node-fetch";
const API_KEY = process.env.ZYLA_API_KEY; // env में YOUR_API_KEY सेट करें
const videoUrl = "https://www.youtube.com/watch?v=aGSKrC7dGcY";
const format = "720"; // नीचे समर्थित मानों की सूची देखें
async function startDownload() {
const endpoint = "https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download";
const url = new URL(endpoint);
url.searchParams.set("url", videoUrl);
url.searchParams.set("format", format);
const res = await fetch(url.toString(), {
method: "GET",
headers: {
Authorization: `Bearer ${API_KEY}`
}
});
if (!res.ok) {
const text = await res.text();
throw new Error(`HTTP ${res.status}: ${text}`);
}
const data = await res.json();
// आधिकारिक नमूने के अनुसार अपेक्षित फ़ील्ड:
// success, id, image, progress_url
console.log("स्वीकृत:", data.success);
console.log("जॉब आईडी:", data.id);
console.log("थंबनेल:", data.image);
console.log("प्रगति URL:", data.progress_url);
// आप अब data.id और data.progress_url को एक कार्यकर्ता/UI से पोल करने के लिए स्थायी कर सकते हैं।
}
startDownload().catch(err => {
console.error("डाउनलोड शुरू करने में विफल:", err);
});समर्थित प्रारूप मान:
- वीडियो: 360p, 480p, 720p, 1080p, 1440p, 2160p
- ऑडियो: mp3, m4a, flac, opus, wav
कार्यान्वयन नोट्स:
- ऑडियो डाउनलोड लिंक 2 घंटे बाद समाप्त हो जाते हैं; अपने कार्यप्रवाह की योजना accordingly करें।
- यह एंडपॉइंट केवल नियमित वीडियो का समर्थन करता है।
वास्तविक दुनिया के एकीकरण टिप्स
- URL एन्कोडिंग: यदि आप मैन्युअल रूप से क्वेरी स्ट्रिंग बनाते हैं, तो सुनिश्चित करें कि YouTube URL cURL उदाहरण में दिखाए अनुसार प्रतिशत-एन्कोडेड है। उच्च-स्तरीय क्लाइंट (URL, Postman में Params टैब) आपके लिए इसे संभालते हैं।
- प्रमाणन हैंडलिंग: प्रमाणीकरण हेडर को
Bearer YOUR_API_KEYके रूप में रखें। कुंजियों को क्वेरी पैरामीटर के रूप में न भेजें। - जॉब ट्रैकिंग: तुरंत
idऔरprogress_urlको अपने डेटा स्टोर में स्थायी करें ताकि कार्यकर्ता या ग्राहक पोल कर सकें और UI को अपडेट कर सकें। - फॉर्मेट चयन: उपयोगकर्ताओं को केवल प्रलेखित सेट की पेशकश करें। वीडियो के लिए: 360p, 480p, 720p, 1080p, 1440p, 2160p। ऑडियो के लिए: mp3, m4a, flac, opus, wav।
- समय-सीमित UX: यदि आप अंतिम उपयोगकर्ताओं को ऑडियो लिंक दिखाते हैं, तो समय-सीमित संदेश दिखाएं क्योंकि लिंक 2 घंटे बाद समाप्त हो जाते हैं।
- त्रुटि सतह: यदि आप एक गैर-2xx प्रतिक्रिया प्राप्त करते हैं, तो डिबगिंग के लिए स्थिति और शरीर दोनों को लॉग करें (जैसा कि JS उदाहरण में दिखाया गया है)।
MCP के माध्यम से AI एजेंटों से API का उपयोग करना
Zyla पर हर API को उन AI एजेंटों से कॉल किया जा सकता है जो मॉडल संदर्भ प्रोटोकॉल (MCP) का समर्थन करते हैं। अपने MCP-संगत क्लाइंट (जैसे, Claude Code, Cursor, Windsurf) को MCP एंडपॉइंट पर इंगित करें और अपनी Zyla API कुंजी प्रदान करें। यहाँ MCP विवरण देखें: MCP। वही प्रमाणीकरण हेडर लागू होता है: Bearer YOUR_API_KEY। एक बार जब उपकरण कॉन्फ़िगर हो जाता है, तो एजेंट को URL और प्रारूप पैरामीटर के साथ डाउनलोड एंडपॉइंट को सक्रिय करने के लिए प्रेरित करें ताकि एक जॉब शुरू हो सके और id, image, और progress_url लौटाए जा सकें।
सामान्य कार्यप्रवाह जिन्हें आप इस सप्ताह भेज सकते हैं
- “डाउनलोड” बटन के लिए बैकएंड API: आपकी सेवा एक YouTube URL प्राप्त करती है, इसे मान्य करती है, और उपयोगकर्ता द्वारा चयनित रिज़ॉल्यूशन या ऑडियो प्रारूप के साथ डाउनलोड एंडपॉइंट को कॉल करती है। यह तुरंत जॉब
idऔरimageको एक उत्तरदायी UI के लिए लौटाता है। - कार्यकर्ता-आधारित रूपांतरण: एक बैकग्राउंड कार्यकर्ता कतारबद्ध कार्यों को पढ़ता है,
progress_urlकी निगरानी करता है, और डेटाबेस स्थिति को अपडेट करता है ताकि आपके ग्राहक उपयोगकर्ता को प्रगति दिखा सकें। - ऑडियो-केवल प्रवाह: पॉडकास्टिंग उपकरणों या ध्वनि पुस्तकालयों के लिए, ऑडियो प्रारूप (mp3, m4a, flac, opus, wav) का अनुरोध करें और एक अनुस्मारक दिखाएं कि लिंक 2 घंटे बाद समाप्त हो जाते हैं।
पुनर्कथन: न्यूनतम फ़ील्ड जिन्हें आपको एकीकृत करने की आवश्यकता है
- एंडपॉइंट: GET https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download
- हेडर्स: Authorization: Bearer YOUR_API_KEY
- क्वेरी पैरामीटर: url, format
- प्रतिक्रिया कोर फ़ील्ड: success, id, image, progress_url
संदर्भ के लिए API पृष्ठ को बुकमार्क करें: Zyla पर YouTube डाउनलोड और जानकारी API। Zyla API Hub पर श्रेणियों में अन्य तैयार-से-उपयोग APIs का अन्वेषण करें।
अक्सर पूछे जाने वाले प्रश्न
क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। Zyla एक सब्सक्रिप्शन + कोटा मॉडल का उपयोग करता है। पहला API आमतौर पर 7-दिन का ट्रायल या 50 अनुरोध प्रदान करता है। वर्तमान विकल्पों के लिए API पृष्ठ की जांच करें।
मैं कौन से प्रारूप अनुरोध कर सकता हूँ?
वीडियो: 360p, 480p, 720p, 1080p, 1440p, 2160p। ऑडियो: mp3, m4a, flac, opus, wav।
मैं प्रमाणीकरण कैसे करूँ?
प्रत्येक अनुरोध के साथ हेडर Authorization: Bearer YOUR_API_KEY भेजें।
क्या मैं लाइव स्ट्रीम डाउनलोड कर सकता हूँ?
यह एंडपॉइंट केवल नियमित वीडियो डाउनलोड का समर्थन करता है।
क्या डाउनलोड लिंक समाप्त होते हैं?
ऑडियो डाउनलोड लिंक 2 घंटे बाद समाप्त हो जाते हैं। अपने प्रवाह को तुरंत उन्हें लाने और उपभोग करने के लिए डिज़ाइन करें।
क्या आप इसे Postman में परीक्षण करने और अपने एकीकरण को भेजने के लिए तैयार हैं? अपना खाता बनाएं, API की सदस्यता लें, और अपनी कुंजी यहाँ प्राप्त करें: पंजीकरण करें। फिर YouTube डाउनलोड और जानकारी API पृष्ठ खोलें और ऊपर दिखाए अनुसार डाउनलोड एंडपॉइंट चलाएँ।
