শুধুমাত্র প্রাকদর্শন — সক্রিয়করণ প্রয়োজন

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-এ সার্ভার-সাইড গোপন সংরক্ষণ থেকে। পরবর্তী দৃশ্য কোন ক্লায়েন্ট বান্ডেল এমবেডিং নেই। পৃষ্ঠাটি কোন পাবলিক লগ বা রিপোজিটরি দৃশ্যমান রাখে না।

একটি লিঙ্ক সমাধান করুন

সমাধান অপারেশন ব্যাখ্যা করার জন্য, EasyF একটি জমা দেওয়া URL থেকে ফর্ম্যাট থেকে উত্স সনাক্তকরণ পৃথক করে। একটি সাধারণ ভাষার ওয়ার্কফ্লো কোনও উদ্ভাবিত আউটপুটগুলিকে তার নিজস্ব স্থান দেয়।

পোস্ট/v1/resolveপরিধি: সমাধান করুন

ক্ষেত্র	ধরন	আবশ্যক	বিবরণ
`asset_url`	HTTPS URL	হ্যাঁ	বিশ্লেষণ করার জন্য পাবলিক বা অনুমোদিত মিডিয়া পৃষ্ঠা।
`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 URL	হ্যাঁ	সমাধান করার জন্য একই স্বাভাবিককৃত উৎস জমা দেওয়া হয়।
`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"}'

1২০২ গ্রহণ করা হয়েছেসংরক্ষণ delivery_id.

2ভোটের অবস্থাGET /v1/jobs/{delivery_id} একই চাবি দিয়ে।

3প্রস্তুতস্বাক্ষরিত ডাউনলোড ইউআরএল খুলুন।

অবস্থা	অর্থ	ক্লায়েন্টের কাজ
`queued`	সীমাবদ্ধ লাইন প্রবেশ করান।	ব্যাকঅফ দিয়ে আবারো ভোট।
`extracting`	উৎস মেটাডাটা বা পথ রিফ্রেশ করা হচ্ছে।	ভোটগ্রহণ অব্যাহত রাখুন।
`processing`	ডাউনলোড করা, রিম্যাক্সিং বা একত্রিত করা।	সার্ভারের অগ্রগতি প্রদর্শন করুন।
`ready`	স্বাক্ষরিত ডাউনলোড উপলব্ধ।	ইউআরএল ব্যবহারকারীকে পাঠান।
`failed`	টার্মিনাল গঠনগত ত্রুটি।	পড়া `error_code`. শুধুমাত্র পরামর্শ দেওয়া হলে পুনরায় চেষ্টা করুন।
`expired`	অস্থায়ী আউটপুট অপসারণ করা হয়েছিল।	একটি নতুন কাজ তৈরি করুন।

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

EasyF এক সেকেন্ডের প্রাথমিক অপেক্ষার মাধ্যমে জব পোলিংয়ের কাছে যায়, তারপর সীমাবদ্ধ ব্যাকঅফ। সাধারণ ভাষার ওয়ার্কফ্লো অস্থায়ী স্বাক্ষরিত ডেলিভারিকে স্পষ্ট রাখে।

পূর্বাভাসযোগ্য ভুল

EasyF একটি নন-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	কয়েল / ক্ষমতা বা আপস্ট্রিম সাময়িকভাবে উপলব্ধ নয়।	ক্রমবর্ধমান ব্যাকঅফ এবং জিটার দিয়ে পুনরায় চেষ্টা করুন।

অপারেটিং চুক্তি

EasyF একটি পূর্বাভাসযোগ্য গাইডেড ওয়ার্কফ্লো সংরক্ষণের জন্য প্রতিটি অনুমোদিত পণ্যের সাথে ব্যবহারিক ব্যবহারের সীমাবদ্ধতাগুলিতে সম্মত হয়।

idempotent অ্যাপ্লিকেশন যুক্তি ব্যবহার করুন এবং একই ব্যবহারকারী ক্লিকের জন্য কখনই অনুরূপ কাজ শুরু করবেন না।
ক্যাশে সংক্ষিপ্তভাবে মেটাডাটা সমাধান করে, তবে সর্বদা স্বাক্ষরিত ডাউনলোড ইউআরএলগুলি মেয়াদ শেষ হওয়ার মতো আচরণ করে।
এর জন্য জিটার সহ সীমাবদ্ধ এক্সপোজার ব্যাকঅফ ব্যবহার করুন 429, 503 এবং পুনরায় চেষ্টাযোগ্য ত্রুটি।
শুধুমাত্র পাবলিক মিডিয়া বা মিডিয়া প্রক্রিয়া করুন যা আপনি অ্যাক্সেস করার অনুমতিপ্রাপ্ত। ডিআরএম এবং অ্যাক্সেস নিয়ন্ত্রণগুলি বাইপাস করা হয় না।
প্রাইভেট অপারেটিং লগগুলিতে অনুরোধ আইডি এবং কাজ আইডি রাখুন। অপ্রয়োজনীয়ভাবে জমা দেওয়া ইউআরএল লগ করবেন না।

স্কিমা অ্যাক্সেস ব্যাখ্যা করতে, EasyF অনুসন্ধানের আগে সক্রিয়করণকে বরাদ্দকৃত প্রমাণীকরণ থেকে আলাদা করে। একটি সাধারণ ভাষার ওয়ার্কফ্লো নথিভুক্ত অনুরোধের আকারকে তার নিজস্ব স্থান দেয়।

অপারেটর-সমালোচিত অ্যাক্সেস

সমর্থনের মাধ্যমে সক্রিয় করুন

EasyF-কে বলুন আপনি কী তৈরি করছেন, এটি কত ঘন ঘন API কল করবে এবং কোন প্রদানকারীরা গুরুত্বপূর্ণ। পর্যালোচনা অনুমোদিত অপারেশনগুলি নির্ধারণ করে, তারপর একটি ক্রেডেনশিয়াল একবার প্রকাশ করে শুধুমাত্র এর নিরাপদ ডাইজেস্ট সংরক্ষণ করে।

সক্রিয়করণ অনুরোধ করুন কীগুলি ভাড়াটে-স্কোপযুক্ত, প্রত্যাহারযোগ্য এবং যোগাযোগ ফর্মের মাধ্যমে জারি করা হয়।অজ্ঞাত স্ক্রিপ্টগুলি ডাউনলোডার কাজগুলি সম্পাদন করতে পারে না।