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