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