صرف پیش نظارہ — فعال سازی ضروری ہے

SaveTK کے ساتھ ڈاؤنلوڈز بنائیں

SaveTK خالق-ٹول انضمامات کے لیے ایک API منصوبہ دکھاتا ہے، لیکن بغیر تصدیق کے عمل درآمد قبول نہیں کرتا۔ منظوری کے ساتھ کلید اور اس کی عملی حدود دونوں فراہم کی جاتی ہیں۔

SaveTkCreatorHTTPS پر JSONغیر ہم وقت نوکریاںمحدود اسناد
01

فوری آغاز

SaveTK API میزبان کے لیے تین عملی نکات پیش کرتا ہے۔ سب سے پہلے سپورٹ سے فعال کردہ اسناد آتی ہیں۔ اس کے بعد محفوظ کرنے کا ورک فلو ایک مختص کردہ ٹیننٹ اینڈپوائنٹ کا احاطہ کرتا ہے۔ اس کا آخری نکتہ صرف سرور کے لیے کال پاتھ ہے۔

کرایہ دار کا URLhttps://savetk.app
تصدیقX-API-Key: pending_activation_…
کلائنٹ پروفائلSaveTkCreator
API ورژنv1
# 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 سندی حفاظت کو آسانی سے جانچنے کے قابل بناتا ہے۔ صفحہ سرور سائیڈ خفیہ ذخیرہ سے شروع ہوتا ہے، پھر کلائنٹ بنڈل میں کسی بھی ایمبیڈنگ نہ ہونے کی طرف جاتا ہے، اور واضح طور پر بتاتا ہے کہ کوئی عوامی لاگز یا ریپوزٹریز نہیں ہیں۔

02

لنک حل کریں

SaveTK حل کے عمل کے لیے تین عملی نکات پیش کرتا ہے۔ سب سے پہلے ماخذ کی شناخت آتی ہے۔ اس کے بعد محفوظ کرنے کا ورک فلو ایک جمع کرائے گئے URL سے فارمیٹس کو شامل کرتا ہے۔ اس کا آخری نکتہ یہ ہے کہ کوئی اختراعی آؤٹ پٹس نہیں ہیں۔

پوسٹ/v1/resolveدائرہ کار: حل کریں
فیلڈقسمضروریتفصیل
creator_linkHTTPS یو آر ایلہاںتجزیہ کرنے کے لیے عوامی یا مجاز میڈیا صفحہ۔
tenantسٹرنگنہیںتفویض کردہ کرایہ دار ڈومین۔ عام طور پر چھوڑ دیا جاتا ہے۔
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

SaveTK فارمیٹ شناخت کنندہ کو آسانی سے اسکین کرنے کے قابل بناتا ہے۔ صفحہ واپس آنے والی قدر سے بغیر کسی تبدیلی کے شروع ہوتا ہے، پھر ہر لنک کی دستیابی کی طرف بڑھتا ہے، اور واضح طور پر بتاتا ہے کہ کوئی اندازہ شدہ معیار کا لیبل نہیں ہے۔

03

ڈاؤنلوڈ جاب بنائیں اور اس کی پیروی کریں

SaveTK پر غیر ہم زمانی تیاری کے ساتھ ملازمت کی تخلیق شروع ہوتی ہے۔ یہ محفوظ کرنے کا ورک فلو پھر ایک مختصر HTTP درخواست پیش کرتا ہے۔ آخری حقیقت محدود ورکر عمل درآمد ہے۔

پوسٹ/v1/jobsدائرہ کار: ملازمتیں
فیلڈقسمضروریتفصیل
creator_linkHTTPS یو آر ایلہاںاسی نارملائزڈ ماخذ کو حل کے لیے جمع کرایا گیا ہے۔
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"}'
1202 منظور شدہمحفوظ کریں save_task.
2رائے شماری کی حالتGET /v1/jobs/{save_task} اسی کلید کے ساتھ۔
3تیاردستخط شدہ ڈاؤن لوڈ URL کھولیں۔
حیثیتمعنیکلائنٹ کا عمل
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 کو مدنظر رکھتا ہے۔

04

متوقع غلطیاں

غلطی کا معاہدہ 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قطار/گنجائش یا اپ اسٹریم عارضی طور پر دستیاب نہیں ہے۔ایکسپونینشل بیک آف اور جیٹر کے ساتھ دوبارہ کوشش کریں۔
05

عملیاتی معاہدہ

SaveTK متوقع ٹریفک اور دائرۂ کار میں موجود پوسٹنگ پلیٹ فارمز کا جائزہ لینے کے بعد تخلیق کار کے ورک فلو کی اجازتیں متعین کرتا ہے۔

SaveTK اسکیما تک رسائی کے لیے تین عملی نکات پیش کرتا ہے۔ پہلا نکتہ دریافت سے پہلے فعال کرنا ہے۔ اس کے بعد محفوظ کرنے کا ورک فلو تفویض شدہ تصدیق کا احاطہ کرتا ہے۔ اس کا آخری نکتہ دستاویزی درخواست کی ساختیں ہیں۔

آپریٹر-جائزہ شدہ رسائی

سپورٹ کے ذریعے فعال کریں

بتائیں کہ SaveTK کلائنٹ کیا کرتا ہے، یہ کتنی کالز کی توقع رکھتا ہے اور کون سی پوسٹنگ سروسز ضروری ہیں۔ سپورٹ ریویو اپنے اسکوپس منتخب کرتا ہے، پھر ایک ناقابلِ بحالی اسناد واپس کرتا ہے جو صرف ایک بار دکھائی جاتی ہے۔

فعالیت کی درخواست کریں چابیاں ٹیننٹ کی حد تک مخصوص، منسوخ کی جا سکنے والی ہیں اور رابطہ فارم کے ذریعے جاری کی جاتی ہیں۔ گمنام اسکرپٹس ڈاؤن لوڈر کا کام انجام نہیں دے سکتیں۔