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