प्रोडक्शन REST API · v1

YTSave से डाउनलोड बनाईं

Public media URL ke resolve kari, ek thik format chuni, asynchronous job banayi aur signed result apne user ke de di. Ee bounded production pipeline YTSave website ke chalawela.

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"}'

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

एक लिंक हल करें

YTSave Resolve ऑपरेशन के संभाले ला पहिले स्रोत पहचान के पहिचान करेला। ई एक भेजल URL से फॉर्मेट्स के अनुसरण करेला आ कवनो बनावल आउटपुट के नजर में ना रखेला।

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

मैदान	प्रकार	जरूरी	विवरण
`url`	HTTPS URL	हाँ	सार्वजनिक या अधिकृत मीडिया पेज विश्लेषण खातिर।
`tenant`	स्ट्रिंग	ना	Nirdharit kirayedar domain. Aksar chhoda jaala.

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

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

डाउनलोड जॉब बनाईं आ अनुसरण करीं

Job निर्माण खातिर, YTSave असिंक्रोनस तैयारी से शुरू करेला। ओकर सबूत रिकॉर्ड एक छोट HTTP अनुरोध के साथ जोड़े ला आ सीमित वर्कर निष्पादन के साथ खत्म करेला।

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

मैदान	प्रकार	जरूरी	विवरण
`url`	HTTPS URL	हाँ	समान सामान्यीकृत स्रोत समाधान खातिर जमा कइल गइल।
`format_id`	स्ट्रिंग	हाँ	रिज़ॉल्व प्रतिक्रिया से एक सटीक आईडी।
`tenant`	स्ट्रिंग	ना	Nirdharit kirayedar domain. Aksar chhoda jaala.

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 Job polling के आसानी से स्कैन करे लायक बनावेला. पन्ना एक सेकंड के शुरुआती इंतजार से शुरू होला, capped backoff पर जाला, आ अस्थायी साइन कइल डिलीवरी के साफ-साफ बतावेला.

पूर्वानुमानित गलती

Error contract खातिर, YTSave एक non-2xx लिफाफा के जांच करे ला support request ID से पहिले. ई सबूत रिकॉर्ड ग्राहक के व्यवहार के साफ-साफ बतावेला.

{
  "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 आ एक्सेस कंट्रोल्स के बाईपास ना कइल जाला।
Request ID aur job ID ke private operational logs me rakhi. Jarurat se adhik submitted URL ke log na kari.

YTSave स्कीमा एक्सेस को पहले सक्रियता की पहचान करके संभालता है फिर अन्वेषण करता है। यह सौंपे गए प्रमाणीकरण के साथ चलता है और अनुरोध के दस्तावेजीकृत रूपों को दृश्य में रखता है। OpenAPI संदर्भ

ऑपरेटर-द्वारा समीक्षा कइल पहुँच

आपन API कुंजी के मांग करीं

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

API पहुँच के माँग करीं कीज टेनेंट-स्कोप्ड, रद्द कइल जा सके वाला आ संपर्क फॉर्म के माध्यम से जारी कइल जाला। गुमनाम स्क्रिप्ट डाउनलोडर काम ना चला सकेला।