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

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

EasyF انٹرفیس کو پہلے سے دکھاتا ہے تاکہ ڈویلپرز اپنے کام کا اندازہ لگا سکیں۔ لائیو کلید اور استعمال کی حد موجود ہونے سے پہلے بھی سپورٹ کا جائزہ درکار ہے۔

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

فوری آغاز

API میزبان کی وضاحت کے لیے، EasyF معاونت-فعال کردہ اسناد کو ایک تفویض شدہ ٹیننٹ اینڈپوائنٹ سے الگ کرتا ہے۔ عام زبان میں ایک ورک فلو سرور-صرف کال پاتھ کو اس کی اپنی جگہ دیتا ہے۔

کرایہ دار کا URLhttps://easyf.app

تصدیقX-API-Key: pending_activation_…

کلائنٹ پروفائلEasyfClient

API ورژنv1

# Available only after support activation
export EASYF_SERVICE_KEY="issued-after-review"

curl -X POST https://easyf.app/v1/resolve \
  -H "X-API-Key: $EASYF_SERVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'

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

لنک حل کریں

Resolve آپریشن کی وضاحت کے لیے، EasyF ایک جمع کرائے گئے URL سے سورس ڈیٹیکشن کو فارمیٹس سے الگ کرتا ہے۔ عام زبان میں ورک فلو کسی بھی من گھڑت آؤٹ پُٹس کو اپنی جگہ نہیں دیتا۔

پوسٹ/v1/resolveدائرہ کار: حل کریں

فیلڈ	قسم	ضروری	تفصیل
`asset_url`	HTTPS یو آر ایل	ہاں	تجزیہ کرنے کے لیے عوامی یا مجاز میڈیا صفحہ۔
`tenant`	سٹرنگ	نہیں	تفویض کردہ کرایہ دار ڈومین۔ عام طور پر چھوڑ دیا جاتا ہے۔

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

فارمیٹ شناخت کنندہ EasyF پر واپس کیے گئے ویلیو کے ساتھ بغیر تبدیلی کے شروع ہوتا ہے۔ اگلا منظر فی-لنک دستیابی کا احاطہ کرتا ہے۔ صفحہ کوئی اندازہ شدہ کوالٹی لیبل ظاہر نہیں رکھتا۔

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

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

پوسٹ/v1/jobsدائرہ کار: ملازمتیں

فیلڈ	قسم	ضروری	تفصیل
`asset_url`	HTTPS یو آر ایل	ہاں	اسی نارملائزڈ ماخذ کو حل کے لیے جمع کرایا گیا ہے۔
`variant_code`	سٹرنگ	ہاں	ریسولو جواب سے ایک درست شناخت۔
`tenant`	سٹرنگ	نہیں	تفویض کردہ کرایہ دار ڈومین۔ عام طور پر چھوڑ دیا جاتا ہے۔

curl -X POST https://easyf.app/v1/jobs \
  -H "X-API-Key: $EASYF_SERVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID","variant_code":"18"}'

1202 منظور شدہمحفوظ کریں delivery_id.

2رائے شماری کی حالتGET /v1/jobs/{delivery_id} اسی کلید کے ساتھ۔

3تیاردستخط شدہ ڈاؤن لوڈ URL کھولیں۔

حیثیت	معنی	کلائنٹ کا عمل
`queued`	محدود قطار میں داخل کیا گیا۔	دوبارہ پول کریں بیک آف کے ساتھ۔
`extracting`	ذریعہ میٹا ڈیٹا یا راستہ تازہ کیا جا رہا ہے۔	پولنگ جاری رکھیں۔
`processing`	ڈاؤن لوڈ، ری مکس یا مرج کر رہے ہیں۔	سرور کی پیش رفت دکھائیں۔
`ready`	دستخط شدہ ڈاؤن لوڈ دستیاب ہے۔	URL صارف کو بھیجیں۔
`failed`	ٹرمینل ساختہ خرابی۔	پڑھیں `error_code`. صرف مشورہ دیے جانے پر دوبارہ کوشش کریں۔
`expired`	عارضی آؤٹ پٹ ہٹا دیا گیا۔	نیا کام بنائیں۔

curl https://easyf.app/v1/jobs/DELIVERY_ID \
  -H "X-API-Key: $EASYF_SERVICE_KEY"

EasyF جاب پولنگ کے لیے پہلے ایک سیکنڈ کی ابتدائی تاخیر استعمال کرتا ہے، پھر حد بندی شدہ بیک آف۔ سادہ زبان والا ورک فلو عارضی دستخط شدہ ترسیل کو واضح رکھتا ہے۔

متوقع غلطیاں

EasyF Error contract کو ایک non-2xx envelope کے گرد منظم کرتا ہے۔ اس کا سادہ زبان میں ورک فلو ایک support request ID کا موازنہ کرتا ہے۔ قابلِ پیش گوئی client handling آخری جانچ رہتی ہے۔

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

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

EasyF ہر منظور شدہ پروڈکٹ کے ساتھ عملی استعمال کی حدود پر متفق ہوتا ہے تاکہ ایک قابلِ پیش گوئی رہنمائی شدہ ورک فلو برقرار رہے۔

idempotent ایپلیکیشن لاجک استعمال کریں اور ایک ہی صارف کے کلک کے لیے کبھی بھی ڈپلیکیٹ جابز شروع نہ کریں۔
کیچ ریزولو میٹاڈیٹا کو مختصر طور پر محفوظ کریں، لیکن دستخط شدہ ڈاؤن لوڈ یو آر ایل کو ہمیشہ میعاد ختم ہونے والا سمجھیں۔
کے لیے جھٹکے کے ساتھ محدود ایکسپونیشنل بیک آف استعمال کریں 429, 503 اور دوبارہ کوشش کے قابل غلطیاں۔
صرف عوامی میڈیا یا وہ میڈیا پروسیس کریں جس تک آپ کو رسائی کی اجازت ہو۔ DRM اور رسائی کے کنٹرولز کو نظرانداز نہیں کیا جاتا۔
درخواست آئی ڈیز اور جاب آئی ڈیز کو نجی آپریشنل لاگز میں رکھیں۔ جمع کرائے گئے URLs کو غیر ضروری طور پر لاگ نہ کریں۔

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

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

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

EasyF کو بتائیں کہ آپ کیا بنا رہے ہیں، یہ API کو کتنی بار کال کرے گا، اور کون سے فراہم کنندگان اہم ہیں۔ جائزہ مجاز کارروائیوں کا فیصلہ کرتا ہے، پھر صرف ایک بار اسناد ظاہر کرتا ہے جبکہ صرف اس کا محفوظ ہیش محفوظ کرتا ہے۔

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