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 یو آر ایل | ہاں | تجزیہ کرنے کے لیے عوامی یا مجاز میڈیا صفحہ۔ |
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 یو آر ایل | ہاں | اسی نارملائزڈ ماخذ کو حل کے لیے جمع کرایا گیا ہے۔ |
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 | دستخط شدہ ڈاؤن لوڈ دستیاب ہے۔ | URL صارف کو بھیجیں۔ |
failed | ٹرمینل ساختہ خرابی۔ | پڑھیں error_code. صرف مشورہ دیے جانے پر دوبارہ کوشش کریں۔ |
expired | عارضی آؤٹ پٹ ہٹا دیا گیا۔ | نیا کام بنائیں۔ |
curl https://savetk.app/v1/jobs/SAVE_TASK \
-H "X-API-Key: $SAVETK_CREATOR_KEY"SaveTK پہلے ایک سیکنڈ کی ابتدائی انتظار کی نشاندہی کرکے Job polling کو سنبھالتا ہے۔ اس کے بعد یہ محدود backoff پر عمل کرتا ہے اور عارضی signed delivery کو مدنظر رکھتا ہے۔
متوقع غلطیاں
غلطی کا معاہدہ SaveTK پر ایک غیر-2xx لفافے کے ساتھ شروع ہوتا ہے۔ اگلا منظر ایک سپورٹ درخواست 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 | قطار/گنجائش یا اپ اسٹریم عارضی طور پر دستیاب نہیں ہے۔ | ایکسپونینشل بیک آف اور جیٹر کے ساتھ دوبارہ کوشش کریں۔ |
عملیاتی معاہدہ
SaveTK متوقع ٹریفک اور دائرۂ کار میں موجود پوسٹنگ پلیٹ فارمز کا جائزہ لینے کے بعد تخلیق کار کے ورک فلو کی اجازتیں متعین کرتا ہے۔
- idempotent ایپلیکیشن لاجک استعمال کریں اور ایک ہی صارف کے کلک کے لیے کبھی بھی ڈپلیکیٹ جابز شروع نہ کریں۔
- کیچ ریزولو میٹاڈیٹا کو مختصر طور پر محفوظ کریں، لیکن دستخط شدہ ڈاؤن لوڈ یو آر ایل کو ہمیشہ میعاد ختم ہونے والا سمجھیں۔
- کے لیے جھٹکے کے ساتھ محدود ایکسپونیشنل بیک آف استعمال کریں
429,503اور دوبارہ کوشش کے قابل غلطیاں۔ - صرف عوامی میڈیا یا وہ میڈیا پروسیس کریں جس تک آپ کو رسائی کی اجازت ہو۔ DRM اور رسائی کے کنٹرولز کو نظرانداز نہیں کیا جاتا۔
- درخواست آئی ڈیز اور جاب آئی ڈیز کو نجی آپریشنل لاگز میں رکھیں۔ جمع کرائے گئے URLs کو غیر ضروری طور پر لاگ نہ کریں۔
SaveTK اسکیما تک رسائی کے لیے تین عملی نکات پیش کرتا ہے۔ پہلا نکتہ دریافت سے پہلے فعال کرنا ہے۔ اس کے بعد محفوظ کرنے کا ورک فلو تفویض شدہ تصدیق کا احاطہ کرتا ہے۔ اس کا آخری نکتہ دستاویزی درخواست کی ساختیں ہیں۔
سپورٹ کے ذریعے فعال کریں
بتائیں کہ SaveTK کلائنٹ کیا کرتا ہے، یہ کتنی کالز کی توقع رکھتا ہے اور کون سی پوسٹنگ سروسز ضروری ہیں۔ سپورٹ ریویو اپنے اسکوپس منتخب کرتا ہے، پھر ایک ناقابلِ بحالی اسناد واپس کرتا ہے جو صرف ایک بار دکھائی جاتی ہے۔
فعالیت کی درخواست کریں چابیاں ٹیننٹ کی حد تک مخصوص، منسوخ کی جا سکنے والی ہیں اور رابطہ فارم کے ذریعے جاری کی جاتی ہیں۔ گمنام اسکرپٹس ڈاؤن لوڈر کا کام انجام نہیں دے سکتیں۔