उत्पादन REST API · v1

YTSave सह डाउनलोड तयार करा

सार्वजनिक मीडिया URL सोडवा, अचूक स्वरूप निवडा, असिंक्रोनस काम तयार करा आणि स्वाक्षरी केलेला निकाल तुमच्या वापरकर्त्याला द्या. त्याच मर्यादित उत्पादन पाइपलाइन YTSave वेबसाइट चालवते.

YTSaveClientHTTPS वर JSONअसिंक्रोनस नोकऱ्यामर्यादित प्रमाणपत्रे

जलद प्रारंभ

YTSave API होस्ट हाताळतो प्रथम समर्थन-सक्रिय प्रमाणपत्रे ओळखून. त्यानंतर नियुक्त भाडेकरू एंडपॉइंट अनुसरतो आणि फक्त सर्व्हर कॉल मार्ग दृश्यमान ठेवतो.

भाडेकरू URLhttps://ytsave.app

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

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

API आवृत्ती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`	स्ट्रिंग	नाही	नेमलेले भाडेकरू डोमेन. सहसा वगळले जाते.

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

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 की मागवा

API वापरकर्त्याचे दस्तऐवजीकरण करा, त्याचा मासिक विनंती अंदाज आणि समर्थित प्लॅटफॉर्म आवश्यकता. YTSave एकदाच दिसणारी की जारी करण्यापूर्वी ठरवते की निराकरण, नोकरी सादर करणे किंवा दोन्ही योग्य आहेत का.

API प्रवेशासाठी विनंती करा कीज भाडेकरू-आधारित, रद्द करण्यायोग्य आणि संपर्क फॉर्मद्वारे जारी केल्या जातात. अनामिक स्क्रिप्ट्स डाउनलोडर कार्य चालवू शकत नाहीत.