https://ytsave.appYTSave सह अप्लोडान् निर्माय
सार्वजनिकमाध्यमURLं समाधानं कुरु, यथार्थं रूपं चयनं कुरु, असमयोजितं कर्म सृज, च हस्ताक्षरितं परिणामं तव उपयोगकर्तृभ्यः दत्तुम्। समं सीमितं उत्पादनपथं YTSave वेबसाइटं सञ्चालयति।
शीघ्रारम्भः
YTSave प्रथमं समर्थन-सक्रियीकृत प्रमाणपत्रान् परीक्ष्य API होस्टं व्यवस्थापयति। ततः निर्दिष्टं भाडादार-अन्तबिन्दुं अनुवर्तते च केवलं सर्वर-कॉल् मार्गं दृश्यमानं धारयति।
X-API-Key: ys_live_…YTSaveClientv1# 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 | सङ्केतः | आम् | समाधानप्रतिक्रियातः यथार्थं परिचयाङ्कः। |
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"}'job_id.GET /v1/jobs/{job_id} समं कुंजीना सह| स्थिति | अर्थः | ग्राहककर्म |
|---|---|---|
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 प्रवेशस्य कुञ्चिकाः भाडागृहपरिधिसम्बद्धाः, प्रत्याहार्याः च सम्पर्कपत्रेण निर्गतानि। नामरहिताः लिपयः डाउनलोडरकार्यं न कर्तुं शक्नुवन्ति।