उत्पादन 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"}'

क्रेडेन्सियल सुरक्षा व्याख्या गर्न, 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"}'

1२०२ स्वीकार गरियोसेभ गर्नुहोस् 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 र पहुँच नियन्त्रणहरू बाइपास हुँदैनन्।
अनुरोध ID र काम ID निजी सञ्चालन लगहरूमा राख्नुहोस्। आवश्यक नभएमा पेश गरिएको URL हरू लग नगर्नुहोस्।

YTSave ले स्कीमा पहुँचलाई पहिला सक्रियता पहिचान गरेर ह्यान्डल गर्छ। यसले तोकिएको प्रमाणीकरण पछ्याउँछ र अनुरोधका ढाँचाहरूलाई दृश्यमा राख्छ। OpenAPI सन्दर्भ

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

तपाईंको API कुञ्जी अनुरोध गर्नुहोस्

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

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