https://quickdl.appQuickDL দিয়ে ডাউনলোড তৈরি করুন
QuickDL ডেভেলপারদের সক্রিয়করণের আগে কমপ্যাক্ট রিকোয়েস্ট মডেল পরিদর্শন করতে দেয়। একটি প্রাইভেট কী এবং কোটা ব্যবহারের যোগ্য হওয়ার আগে সাপোর্টকে পণ্য যাচাই করতে হবে।
দ্রুত শুরু করুন
QuickDL-এ, API হোস্ট ব্যাখ্যা করার সময় প্রথমে সাপোর্ট-সক্রিয় ক্রেডেনশিয়াল আসে। সেই সংক্ষিপ্ত ইউটিলিটি একটি নির্ধারিত টেন্যান্ট এন্ডপয়েন্টের সাথে অনুসরণ করে এবং একটি সার্ভার-শুধু কল পাথ দিয়ে শেষ হয়।
X-API-Key: pending_activation_…QuickDlJobsv1# Available only after support activation
export QUICKDL_JOB_KEY="issued-after-review"
curl -X POST https://quickdl.app/v1/resolve \
-H "X-API-Key: $QUICKDL_JOB_KEY" \
-H "Content-Type: application/json" \
-d '{"public_link":"https://www.youtube.com/watch?v=VIDEO_ID"}'QuickDL ক্রেডেনশিয়াল সুরক্ষা পরিচালনা করে প্রথমে সার্ভার-সাইড সিক্রেট স্টোরেজ সনাক্ত করে। এটি কোন ক্লায়েন্ট বান্ডেল এমবেডিং করে না এবং কোন পাবলিক লগ বা রিপোজিটরি দৃশ্যে রাখে না।
একটি লিঙ্ক সমাধান করুন
QuickDL এ, রেজলভ অপারেশন ব্যাখ্যা করার সময় প্রথমে সোর্স সনাক্তকরণ হয়। সেই সংক্ষিপ্ত ইউটিলিটি একটি জমা দেওয়া URL থেকে ফরম্যাটগুলি অনুসরণ করে এবং কোন উদ্ভাবিত আউটপুট ছাড়াই শেষ হয়।
/v1/resolveপরিধি: সমাধান করুন| ক্ষেত্র | ধরন | আবশ্যক | বিবরণ |
|---|---|---|---|
public_link | HTTPS URL | হ্যাঁ | বিশ্লেষণ করার জন্য পাবলিক বা অনুমোদিত মিডিয়া পৃষ্ঠা। |
tenant | পংক্তি | নাম | বরাদ্দকৃত ভাড়াটিয়া ডোমেইন।সাধারণত বাদ দেওয়া হয়। |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}QuickDL ফরম্যাট শনাক্তকারী পরিচালনা করে প্রথমে ফেরত দেওয়া মান অপরিবর্তিত রেখে শনাক্ত করে। এটি প্রতিটি লিঙ্কের উপলব্ধতার সাথে অনুসরণ করে এবং কোনও অনুমানকৃত গুণমান লেবেল দৃশ্যে রাখে না।
একটি ডাউনলোড কাজ তৈরি করুন এবং অনুসরণ করুন
QuickDL-এর কমপ্যাক্ট ইউটিলিটি জব তৈরি করার জন্য অ্যাসিঙ্ক্রোনাস প্রস্তুতি পর্যালোচনা করে। এটি পরবর্তী একটি সংক্ষিপ্ত HTTP অনুরোধ দেখায় এবং সীমাবদ্ধ কর্মী কার্যক্রমকে অস্পষ্ট করে না।
/v1/jobsপরিধি: চাকরি| ক্ষেত্র | ধরন | আবশ্যক | বিবরণ |
|---|---|---|---|
public_link | HTTPS URL | হ্যাঁ | সমাধান করার জন্য একই স্বাভাবিককৃত উৎস জমা দেওয়া হয়। |
download_option | পংক্তি | হ্যাঁ | সমাধান প্রতিক্রিয়া থেকে একটি সঠিক আইডি। |
tenant | পংক্তি | নাম | বরাদ্দকৃত ভাড়াটিয়া ডোমেইন।সাধারণত বাদ দেওয়া হয়। |
curl -X POST https://quickdl.app/v1/jobs \
-H "X-API-Key: $QUICKDL_JOB_KEY" \
-H "Content-Type: application/json" \
-d '{"public_link":"https://www.youtube.com/watch?v=VIDEO_ID","download_option":"18"}'quick_job.GET /v1/jobs/{quick_job} একই চাবি দিয়ে।| অবস্থা | অর্থ | ক্লায়েন্টের কাজ |
|---|---|---|
queued | সীমাবদ্ধ লাইন প্রবেশ করান। | ব্যাকঅফ দিয়ে আবারো ভোট। |
extracting | উৎস মেটাডাটা বা পথ রিফ্রেশ করা হচ্ছে। | ভোটগ্রহণ অব্যাহত রাখুন। |
processing | ডাউনলোড করা, রিম্যাক্সিং বা একত্রিত করা। | সার্ভারের অগ্রগতি প্রদর্শন করুন। |
ready | স্বাক্ষরিত ডাউনলোড উপলব্ধ। | ইউআরএল ব্যবহারকারীকে পাঠান। |
failed | টার্মিনাল গঠনগত ত্রুটি। | পড়া error_code. শুধুমাত্র পরামর্শ দেওয়া হলে পুনরায় চেষ্টা করুন। |
expired | অস্থায়ী আউটপুট অপসারণ করা হয়েছিল। | একটি নতুন কাজ তৈরি করুন। |
curl https://quickdl.app/v1/jobs/QUICK_JOB \
-H "X-API-Key: $QUICKDL_JOB_KEY"QuickDL জব পোলিংয়ের জন্য তিনটি ব্যবহারিক পয়েন্ট উপস্থাপন করে। প্রথমে এক-সেকেন্ড প্রাথমিক অপেক্ষা আসে। কম্প্যাক্ট ইউটিলিটি তারপরে ক্যাপড ব্যাকঅফকে কভার করে। এর শেষ পয়েন্টটি অস্থায়ী স্বাক্ষরিত ডেলিভারি।
পূর্বাভাসযোগ্য ভুল
QuickDL ত্রুটি চুক্তিতে পৌঁছায় একটি নন-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 | কয়েল / ক্ষমতা বা আপস্ট্রিম সাময়িকভাবে উপলব্ধ নয়। | ক্রমবর্ধমান ব্যাকঅফ এবং জিটার দিয়ে পুনরায় চেষ্টা করুন। |
অপারেটিং চুক্তি
QuickDL একটি কমপ্যাক্ট, ক্লায়েন্ট-নির্দিষ্ট কোটা প্রদান করে যা উৎস পরিষেবাগুলিকে অস্থিতিশীল না করে ইন্টিগ্রেশনকে সমর্থন করে।
- idempotent অ্যাপ্লিকেশন যুক্তি ব্যবহার করুন এবং একই ব্যবহারকারী ক্লিকের জন্য কখনই অনুরূপ কাজ শুরু করবেন না।
- ক্যাশে সংক্ষিপ্তভাবে মেটাডাটা সমাধান করে, তবে সর্বদা স্বাক্ষরিত ডাউনলোড ইউআরএলগুলি মেয়াদ শেষ হওয়ার মতো আচরণ করে।
- এর জন্য জিটার সহ সীমাবদ্ধ এক্সপোজার ব্যাকঅফ ব্যবহার করুন
429,503এবং পুনরায় চেষ্টাযোগ্য ত্রুটি। - শুধুমাত্র পাবলিক মিডিয়া বা মিডিয়া প্রক্রিয়া করুন যা আপনি অ্যাক্সেস করার অনুমতিপ্রাপ্ত। ডিআরএম এবং অ্যাক্সেস নিয়ন্ত্রণগুলি বাইপাস করা হয় না।
- প্রাইভেট অপারেটিং লগগুলিতে অনুরোধ আইডি এবং কাজ আইডি রাখুন। অপ্রয়োজনীয়ভাবে জমা দেওয়া ইউআরএল লগ করবেন না।
QuickDL-এ, Schema অ্যাক্সেস ব্যাখ্যা করার সময় অনুসন্ধানের আগে সক্রিয়করণ প্রথমে আসে। সেই সংক্ষিপ্ত ইউটিলিটি নির্ধারিত প্রমাণীকরণের সাথে অনুসরণ করে এবং নথিভুক্ত অনুরোধের আকারে শেষ হয়।
সমর্থনের মাধ্যমে সক্রিয় করুন
QuickDL-কে ইন্টিগ্রেশন নাম, প্রত্যাশিত মাসিক পরিমাণ এবং প্রয়োজনীয় উৎস প্রদান করুন। সার্ভার যে অপারেশনগুলি সম্পাদন করবে তা চিহ্নিত করুন যাতে অনুমোদন একটি সংকীর্ণ পরিসরের, এককালীন কী তৈরি করে।
সক্রিয়করণ অনুরোধ করুন কীগুলি ভাড়াটে-স্কোপযুক্ত, প্রত্যাহারযোগ্য এবং যোগাযোগ ফর্মের মাধ্যমে জারি করা হয়।অজ্ঞাত স্ক্রিপ্টগুলি ডাউনলোডার কাজগুলি সম্পাদন করতে পারে না।