প্ৰডাকশ্যন ৰেষ্ট API · v1

YTSaveৰ সৈতে ডাউনলোড নিৰ্মাণ কৰক

এটা ৰাজহুৱা মিডিয়া URL সমাধান কৰক, এটা সঠিক ফৰ্মেট বাছনি কৰক, এটা অসামৰ্থক কাম সৃষ্টি কৰক আৰু স্বাক্ষৰিত ফলাফল আপোনাৰ ব্যৱহাৰকাৰীক দিয়ক। একে সীমাবদ্ধ উৎপাদন পাইপলাইন YTSave ৱেবছাইটক শক্তি যোগায়।

YTSaveClientHTTPSৰ ওপৰত JSONঅসিঙ্ক্ৰনাছ কৰ্মসমূহসীমাবদ্ধ প্ৰমাণপত্ৰসমূহ

দ্ৰুত আৰম্ভণি

YTSave এপিআই হোস্ট পৰিচালনা কৰে প্ৰথমে সমৰ্থিত সক্ৰিয় কৰা প্ৰমাণপত্ৰ চিনাক্ত কৰি। তাৰ পিছত নিযুক্ত টেনেণ্ট এণ্ডপইণ্ট অনুসৰণ কৰে আৰু কেৱল ছাৰ্ভাৰ কল পথ মনত ৰাখে।

ভাড়াতীয়াৰ 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 ৰিজল্ভ অপাৰেশ্বন সামলাই প্রথমে উৎস চিনাক্ত কৰে। ই এটা দাখিল কৰা 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 কৰ্ম পোলিং সহজে স্কেন কৰিবলৈ কৰে। পৃষ্ঠাটো এটা ছেকেণ্ডৰ প্ৰাৰম্ভিক অপেক্ষাৰ সৈতে আৰম্ভ হয়, সীমিত বেকঅফলৈ আগবাঢ়ে, আৰু স্পষ্টকৈ সাময়িক স্বাক্ষৰিত ডেলিভাৰী উল্লেখ কৰে।

পূৰ্বানুমানযোগ্য ত্ৰুটি

Error contractৰ বাবে, YTSave এটা non-2xx এনভেলপ পৰীক্ষা কৰে support request IDৰ আগতে। এই প্ৰমাণ ৰেকৰ্ডে আগতীয়াকৈ ক্লায়েন্ট হেণ্ডলিং স্পষ্ট কৰে।

{
  "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 প্ৰৱেশৰ অনুৰোধ কৰক কীসমূহ ভাড়াতীয়া-সীমিত, প্রত্যাহাৰযোগ্য আৰু যোগাযোগ ফৰ্মৰ জৰিয়তে জাৰি কৰা হয়। অজ্ঞাত স্ক্ৰিপ্টে ডাউনলোডাৰ কাম চলাব নোৱাৰে।