उत्पादन REST API · v1

YTSave सँ डाउनलोड बनाउ

एक सार्वजनिक मीडिया URL समाधान करू, एक सटीक प्रारूप चुनू, एक असिंक्रोनस कार्य बनाउ आ हस्ताक्षरित परिणाम केँ अपन उपयोगकर्ता केँ सौंपू। एकहि सीमित उत्पादन पाइपलाइन YTSave वेबसाइट केँ संचालित करैत अछि।

YTSaveClientHTTPS पर JSONअसिंक्रोनस काज सभसीमित प्रमाण-पत्र

शीघ्र प्रारंभ

YTSave API होस्ट के संभालैत अछि पहिने समर्थन-सक्रिय प्रमाण-पत्र के पहचान कऽ कऽ। ई एक असाइन कएल गेल टेनेंट एंडपॉइंट के अनुसरण करैत अछि आ केवल सर्वर कॉल पथ के दृश्य मे रखैत अछि।

किरायेदार URLhttps://ytsave.app

प्रमाणीकरणX-API-Key: ys_live_…

क्लाइंट प्रोफाइलYTSaveClient

एपीआई संस्करणv1

# Available only after support activation
export YTSAVE_API_KEY="issued-after-review"

curl -X POST https://ytsave.app/v1/resolve \
  -H "X-API-Key: $YTSAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=VIDEO_ID"}'

Credential सुरक्षा के व्याख्या करबा लेल, YTSave सर्वर-पक्षीय गुप्त भंडारण के क्लाइंट बंडल में कोनो समावेशन सँ अलग करैत अछि। एकटा प्रमाण रिकॉर्ड कोनो सार्वजनिक लॉग या रिपॉजिटरी के अपन स्थान नहि दैत अछि।

एक लिंक समाधान करू

YTSave समाधान संचालन के पहिने स्रोत पहचान के पहिचान करैत अछि। ई एक जमा कएल गेल URL सँ फॉर्मेट के अनुसरण करैत अछि आ दृश्य में कोनो आविष्कृत आउटपुट नहि रखैत अछि।

पोस्ट/v1/resolveस्कोप: समाधान करू

मैदान	प्रकार	आवश्यक	विवरण
`url`	HTTPS URL	हाँ	विश्लेषण करबाक लेल सार्वजनिक वा अधिकृत मीडिया पृष्ठ
`tenant`	स्ट्रिंग	नहि	निर्धारित किरायेदार डोमेन। सामान्यतः छोड़ल जाइत अछि।

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

फॉर्मेट पहचानकर्ता के व्याख्या करबाक लेल, YTSave प्रति-लिंक उपलब्धता सँ बिना बदलेल मूल्य अलग करैत अछि। एक प्रमाण रिकॉर्ड अनुमानित गुणवत्ता लेबल के अपन स्थान नहि दैत अछि।

एकटा डाउनलोड काज बनाउ आ अनुसरण करू

नौकरी निर्माण के लेल, YTSave असिंक्रोनस तैयारी सँ शुरू करैत अछि। ओकर प्रमाण रिकॉर्ड एक छोट HTTP अनुरोध के संग जोड़ैत अछि आ सीमित कार्यकर्ता निष्पादन के समाप्त करैत अछि।

पोस्ट/v1/jobsक्षेत्र: नौकरी

मैदान	प्रकार	आवश्यक	विवरण
`url`	HTTPS URL	हाँ	समान सामान्यीकृत स्रोत समाधान लेल प्रस्तुत कएल गेल।
`format_id`	स्ट्रिंग	हाँ	रिज़ॉल्व प्रतिक्रिया सँ एकटा सटीक ID।
`tenant`	स्ट्रिंग	नहि	निर्धारित किरायेदार डोमेन। सामान्यतः छोड़ल जाइत अछि।

curl -X POST https://ytsave.app/v1/jobs \
  -H "X-API-Key: $YTSAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=VIDEO_ID","format_id":"18"}'

1202 स्वीकार कएल गेलसहेजू job_id.

2मतदान स्थितिGET /v1/jobs/{job_id} एके चाबी सँ

3तयारहस्ताक्षरित डाउनलोड URL खोलू।

स्थिति	अर्थ	ग्राहक क्रिया
`queued`	सीमित कतार मे प्रवेश कएल गेल।	पाछाँ हटिकय फेर मतदान करू।
`extracting`	स्रोत मेटाडेटा वा मार्ग ताजा क' रहल अछि।	पोलिंग जारी राखू।
`processing`	डाउनलोड कऽ रहल अछि, रिमक्स कऽ रहल अछि वा मर्ज कऽ रहल अछि।	सर्वर प्रगति देखाउ।
`ready`	हस्ताक्षरित डाउनलोड उपलब्ध अछि।	URL केँ उपयोगकर्ता केँ पठाउ।
`failed`	टर्मिनल संरचित त्रुटि।	पढ़ू `error_code`. केवल सलाह देल गेल पर पुनः प्रयास करू।
`expired`	अस्थायी आउटपुट हटा देल गेल।	एकटा नव काज बनाउ।

curl https://ytsave.app/v1/jobs/JOB_ID \
  -H "X-API-Key: $YTSAVE_API_KEY"

YTSave जॉब पोलिंग के स्कैन करब आसान बनबैत अछि। पृष्ठ एक सेकंड के प्रारंभिक प्रतीक्षा सँ शुरू होइत अछि, सीमित बैकऑफ पर बढ़ैत अछि, आ स्पष्ट रूप सँ अस्थायी हस्ताक्षरित वितरण के बतबैत अछि।

पूर्वानुमानित त्रुटि सभ

त्रुटि अनुबंध के लेल, YTSave एकटा गैर-2xx लिफाफा के समर्थन अनुरोध आईडी सँ पहिने जाँच करैत अछि। ई प्रमाण रिकॉर्ड ग्राहक के व्यवहार के पूर्वानुमानित करब स्पष्ट करैत अछि।

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "category": "rate_limited",
    "message": "Too many requests. Please try again shortly.",
    "retryable": true,
    "details": {"retry_after_seconds": 20}
  },
  "request_id": "…"
}

HTTP	सामान्य अर्थ	कार्य
400	अमान्य URL, शरीर वा अनुपलब्ध प्रारूप।	अनुरोध के सही करू। फॉर्मेट सभ लेल फेर सँ समाधान करू।
401	गुम, अमान्य, समाप्त भऽ गेल वा गलत-स्कोप कुंजी।	सर्वर-पक्षीय प्रमाण-पत्र जाँचू।
403	किरायेदार वा स्रोत नीति अनुरोध केँ अस्वीकृत कयलक।	नीति केँ बाइपास नहि करू। सहायता सँ संपर्क करू।
404	अज्ञात वा समाप्त भऽ गेल काज।	यदि उचित हो तऽ एकटा नव काज बनाउ।
429	अनुरोध वा सक्रिय-काज सीमा पहुँचि गेल अछि।	सम्मान `retry_after_seconds`.
503	कतार/क्षमता वा अपस्ट्रीम अस्थायी रूप सँ अनुपलब्ध।	घातांकी पिछला प्रयास आ जिटर सँ पुनः प्रयास करू।

संचालन अनुबंध

YTSave प्रत्येक अनुमोदन पर एक परिचालन कोटा जारी करैत अछि जे API उपभोक्ता आ अपस्ट्रीम मीडिया सेवासभ के सुरक्षा करैत अछि।

आइडेम्पोटेंट एप्लिकेशन लॉजिकक उपयोग करू आ एकहि उपयोगकर्ता क्लिक लेल दोहराएल काज कखनो शुरू नहि करू।
कैश समाधान मेटाडेटा केँ संक्षिप्त काल लेल राखू, मुदा सदा हस्ताक्षरित डाउनलोड URL केँ समाप्त होमय वाला मानू।
जिटर संग बाउंडेड एक्सपोनेंशियल बैकऑफ के उपयोग करू 429, 503 आ पुनः प्रयास योग्य त्रुटि सभ।
केवल सार्वजनिक मीडिया या वह मीडिया संसाधित करें जिसके लिए आपको अनुमति प्राप्त है। DRM और पहुँच नियंत्रणों को बायपास नहीं किया जाता है।
निजी परिचालन लॉग में अनुरोध आईडी आ जॉब आईडी राखू। अनावश्यक रूप सं जमा कएल गेल URL के लॉग नहि करू।

YTSave स्कीमा पहुँच के पहिने सक्रियता के पहचान कऽ कऽ संभालैत अछि। ई सौंपल प्रमाणीकरण के अनुसरण करैत अछि आ अनुरोध के दस्तावेजीकृत रूप के दृश्य में रखैत अछि। OpenAPI संदर्भ

ऑपरेटर-समीक्षित पहुँच

अपन API कुंजी के अनुरोध करू

एपीआई उपभोक्ता, ओकर मासिक अनुरोध अनुमान आ समर्थित प्लेटफॉर्म आवश्यकतासभक दस्तावेजीकरण करू। YTSave समीक्षा करैत अछि जे समाधान, कार्य प्रस्तुति वा दुनू उचित अछि कि नहि एक बेर देखाएल गेल कुंजी जारी करबाक पूर्व।

API पहुँच के अनुरोध करू कुंजी किरायेदार-स्कोप्ड, रद्द करने योग्य और संपर्क फ़ॉर्म के माध्यम से जारी की जाती हैं। गुमनाम स्क्रिप्ट डाउनलोडर कार्य निष्पादित नहीं कर सकते।