उत्पादनं REST API · v1

YTSave सह अप्लोडान् निर्माय

सार्वजनिकमाध्यमURLं समाधानं कुरु, यथार्थं रूपं चयनं कुरु, असमयोजितं कर्म सृज, च हस्ताक्षरितं परिणामं तव उपयोगकर्तृभ्यः दत्तुम्। समं सीमितं उत्पादनपथं YTSave वेबसाइटं सञ्चालयति।

YTSaveClientHTTPS उपरि JSONअसमयोजितकार्याणिसीमित प्रमाणपत्राणि
01

शीघ्रारम्भः

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 सर्वरपार्श्वे गूढसङ्ग्रहं क्लायंट्-बण्डलेन न संयोजयन् पृथक् करोति। साक्ष्यलेखः न किञ्चन सार्वजनिकलिपिकानां वा सञ्चिकानां स्वस्थानं ददाति।

02

सङ्केतं समाधानं कुरु

YTSave समाधान-क्रियाम् प्रथमं स्रोत-निदानं चिनोति। ततः एकस्मात् समर्पित-URL इत्यस्मात् रूपरेखाः अनुगच्छति च कल्पित-आउटपुट् दृश्ये न धारयति।

प्रेषयतु/v1/resolveपरिधिः: समाधानं कुर्वन्तु
क्षेत्रम्प्रकारःआवश्यकःवर्णनम्
urlHTTPS URLआम्विश्लेषणाय सार्वजनिकं वा अधिकृतं माध्यमपृष्ठं
tenantसङ्केतःनिर्दिष्टः भाडागृह-क्षेत्रः। सामान्यतः त्यज्यते।
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

रूप-परिचायकस्य व्याख्यायै, YTSave प्रत्यागतम् मूल्यं प्रति-सङ्केत-उपलब्धतया अपरिवर्तितं पृथक् करोति। प्रमाणलेखः अनुमानितगुण-लेखं स्वस्थानं न ददाति।

03

डाउनलोड् कर्म निर्माणं च अनुगच्छन्तु

कार्य-निर्माणाय, YTSave असमयिक-तैयारीतः आरभते। तस्य साक्ष्य-लेखः लघु-HTTP-याचना सह योजयति च सीमित-कर्मचारी-कार्यसमापनं करोति।

प्रेषयतु/v1/jobsपरिधिः: कर्माणि
क्षेत्रम्प्रकारःआवश्यकःवर्णनम्
urlHTTPS 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"}'
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 कर्म-परिक्षणं सुगमं करोति। पृष्ठं एकस्मिन् क्षणिके प्रारम्भिके प्रतीक्षायाः आरभते, सीमितं प्रत्यागमनं प्रति गच्छति, च स्पष्टतया अस्थायी हस्ताक्षरितं वितरणं सूचयति।

04

पूर्वानुमेयाः दोषाः

दोषसंविदायै, 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पङ्क्तिः/क्षमता वा ऊर्ध्वप्रवाहः क्षणिकं अनुपलब्धः।घातात्मक प्रत्यावर्तनं च कम्पनं सह पुनः प्रयासः।
05

कार्यात्मक अनुबंधः

YTSave प्रत्येकं अनुमोदनेन कार्यात्मकं कोटां निर्गच्छति यत् API उपभोक्तारं च उच्चस्तरीयं माध्यमसेवान् रक्षति।

YTSave स्कीमाप्रवेशं प्रथमं सक्रियतां परीक्ष्य तदा अन्वेषणं कुर्वन् व्यवस्थापयति। ततः निर्दिष्टप्रमाणीकृतिं अनुगच्छति च अभिलेखितप्रार्थनारूपाणि दृष्टौ धारयति। OpenAPI संदर्भः

परिचालक-समिक्षित प्रवेशः

तव API कुञ्चिका याचय

एपीआइ उपभोक्तारं, मासिकं याचना अनुमानं च समर्थितप्लेटफॉर्म् आवश्यकतानि च दत्तानि। YTSave परीक्षते यत् समाधानं, कर्मप्रेषणं वा उभयतः उचितं वा, एकवारं दृश्यं कुंजीं प्रदातुं पूर्वम्।

अनुरोधं API प्रवेशस्य कुञ्चिकाः भाडागृहपरिधिसम्बद्धाः, प्रत्याहार्याः च सम्पर्कपत्रेण निर्गतानि। नामरहिताः लिपयः डाउनलोडरकार्यं न कर्तुं शक्नुवन्ति।