https://ytsave.appYTSave দিয়ে ডাউনলোড তৈরি করুন
একটি পাবলিক মিডিয়া ইউআরএল সমাধান করুন, একটি নির্দিষ্ট ফর্ম্যাট নির্বাচন করুন, একটি অ্যাসিঙ্ক্রোনাস কাজ তৈরি করুন এবং আপনার ব্যবহারকারীর কাছে স্বাক্ষরিত ফলাফলটি হস্তান্তর করুন একই সীমাবদ্ধ উত্পাদন পাইপলাইনটি 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 | স্বাক্ষরিত ডাউনলোড উপলব্ধ। | ইউআরএল ব্যবহারকারীকে পাঠান। |
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": "…"
}| এইচটিটিপি | সাধারণ অর্থ | কর্ম |
|---|---|---|
| 400 | অবৈধ ইউআরএল, শরীর বা উপলব্ধ নয় ফর্ম্যাট। | অনুরোধটি সংশোধন করুন ফরম্যাটগুলির জন্য আবার সমাধান করুন। |
| 401 | অনুপস্থিত, অবৈধ, মেয়াদোত্তীর্ণ বা ভুল-স্কোপ কী। | সার্ভার-সাইড ক্রেডেনশিয়াল পরীক্ষা করুন। |
| 403 | ভাড়াটে বা উৎস নীতি অনুরোধ প্রত্যাখ্যান। | নীতি বাইপাস করবেন না।সমর্থনের সাথে যোগাযোগ করুন। |
| 404 | অজানা বা মেয়াদ উত্তীর্ণ কাজ। | উপযুক্ত হলে একটি নতুন কাজ তৈরি করুন। |
| 429 | অনুরোধ বা সক্রিয়-কর্ম সীমায় পৌঁছেছে। | সম্মান retry_after_seconds. |
| 503 | কয়েল / ক্ষমতা বা আপস্ট্রিম সাময়িকভাবে উপলব্ধ নয়। | ক্রমবর্ধমান ব্যাকঅফ এবং জিটার দিয়ে পুনরায় চেষ্টা করুন। |
অপারেটিং চুক্তি
YTSave প্রতিটি অনুমোদনের সাথে একটি অপারেশনাল কোটা ইস্যু করে যাতে API ভোক্তা এবং আপস্ট্রিম মিডিয়া পরিষেবাগুলিকে সুরক্ষা দেয়।
- idempotent অ্যাপ্লিকেশন যুক্তি ব্যবহার করুন এবং একই ব্যবহারকারী ক্লিকের জন্য কখনই অনুরূপ কাজ শুরু করবেন না।
- ক্যাশে সংক্ষিপ্তভাবে মেটাডাটা সমাধান করে, তবে সর্বদা স্বাক্ষরিত ডাউনলোড ইউআরএলগুলি মেয়াদ শেষ হওয়ার মতো আচরণ করে।
- এর জন্য জিটার সহ সীমাবদ্ধ এক্সপোজার ব্যাকঅফ ব্যবহার করুন
429,503এবং পুনরায় চেষ্টাযোগ্য ত্রুটি। - শুধুমাত্র পাবলিক মিডিয়া বা মিডিয়া প্রক্রিয়া করুন যা আপনি অ্যাক্সেস করার অনুমতিপ্রাপ্ত। ডিআরএম এবং অ্যাক্সেস নিয়ন্ত্রণগুলি বাইপাস করা হয় না।
- প্রাইভেট অপারেটিং লগগুলিতে অনুরোধ আইডি এবং কাজ আইডি রাখুন। অপ্রয়োজনীয়ভাবে জমা দেওয়া ইউআরএল লগ করবেন না।
YTSave প্রথমে সক্রিয়করণ সনাক্ত করে তারপর অনুসন্ধানের মাধ্যমে স্কিমা অ্যাক্সেস পরিচালনা করে। এটি নির্ধারিত প্রমাণীকরণ অনুসরণ করে এবং নথিভুক্ত অনুরোধের আকারগুলি দৃশ্যে রাখে। ওপেনএপিআই রেফারেন্স
আপনার API কী অনুরোধ করুন
API ভোক্তা, তার মাসিক অনুরোধ অনুমান এবং সমর্থিত প্ল্যাটফর্মের প্রয়োজনীয়তাগুলি নথিভুক্ত করুন। YTSave যাচাই করে যে রেজলভ, কাজ জমা দেওয়া বা উভয়ই যুক্তিযুক্ত কিনা একবার দৃশ্যমান কী ইস্যু করার আগে।
API অ্যাক্সেস অনুরোধ করুন কীগুলি ভাড়াটে-স্কোপযুক্ত, প্রত্যাহারযোগ্য এবং যোগাযোগ ফর্মের মাধ্যমে জারি করা হয়।অজ্ঞাত স্ক্রিপ্টগুলি ডাউনলোডার কাজগুলি সম্পাদন করতে পারে না।