API যা যা কভার করে

ইন্টারফেস ড্যাশবোর্ডে যা করা যায় তারই প্রতিফলন। অ্যাকাউন্টের তথ্য ও স্টোরেজ পড়া, আপলোড সার্ভার চেয়ে ফাইল পাঠানো, URL থেকে ভিডিও ইমপোর্ট, ফাইল তালিকা ও পরিদর্শন, সরানো ও নাম বদল, ফোল্ডার তৈরি, ভিডিও সার্চ এবং রিমোট আপলোড কিউ পরিচালনা করতে পারবেন। কয়েকটি বাড়তি সুবিধায় রিমোট ঠিকানা থেকে স্প্ল্যাশ ছবি বা সাবটাইটেল যুক্ত করা যায়।

রিকোয়েস্ট সাধারণ HTTP GET বা POST। আপনার API কী key প্যারামিটারে যায় এবং অ্যাকাউন্ট সেটিংসে পাওয়া যায়। প্রতিটি উত্তর JSON, যাতে message, স্ট্যাটাস কোড, সার্ভার সময় ও result থাকে। 429 স্ট্যাটাস মানে আপনি প্রতি সেকেন্ডে 10 রিকোয়েস্টের সীমায় পৌঁছেছেন; বেশি লাগলে সাপোর্টে যোগাযোগ করুন।

সাধারণ ইন্টিগ্রেশন

বিল্ড সার্ভার থেকে রেন্ডার করা ভিডিও সরাসরি পাঠানোর পাবলিশিং ওয়ার্কফ্লো, স্প্রেডশিট থেকে লিংক ইমপোর্ট করা কনটেন্ট টুল, সাইটে ক্রিয়েটরের লাইব্রেরি দেখানো প্লাগইন এবং এনকোডিং স্ট্যাটাস নজরে রাখা মনিটরিং স্ক্রিপ্ট। অফিশিয়াল PHP ও Python ক্লায়েন্ট শীঘ্রই আসছে বলে তালিকাভুক্ত, তাই এখন নিচের মতো সরাসরি এন্ডপয়েন্ট কল করুন।

এন্ডপয়েন্ট গ্রুপ

নথিভুক্ত মেথডের সারসংক্ষেপ।

অ্যাকাউন্ট

প্রোফাইল, ব্যালেন্স ও স্টোরেজ পড়ুন, তারিখের পরিসরে রিপোর্ট স্ট্যাটস নিন এবং DMCA নোটিশ তালিকাভুক্ত করুন।

আপলোড

আপলোড সার্ভার চান, তারপর ফাইল মাল্টিপার্ট ফর্ম ডেটা হিসেবে পোস্ট করে কোড ও লিংক ফেরত পান।

রিমোট আপলোড

URL যোগ করুন, জব তালিকা, স্ট্যাটাস ও স্লট দেখুন এবং ব্যর্থ ইমপোর্ট রিস্টার্ট বা মুছুন।

ফোল্ডার

ফোল্ডার ও তার ভেতরের ফাইল তৈরি, নাম বদল ও তালিকাভুক্ত করুন।

ফাইল

ফাইল তালিকা, যাচাই, পরিদর্শন, নাম বদল, সরানো ও ক্লোন করুন এবং থাম্বনেইল আনুন।

খুঁজুন

সার্চ টার্মে ভিডিও খুঁজুন এবং URL থেকে স্প্ল্যাশ ছবি বা সাবটাইটেল যুক্ত করুন।

আপনার প্রথম কল করুন

  1. 1লগ ইন করে অ্যাকাউন্ট সেটিংস পাতা থেকে API কী কপি করুন।
  2. 2কী কাজ করছে কি না দেখতে এবং স্টোরেজ ও ব্যালেন্স জানতে অ্যাকাউন্ট ইনফো এন্ডপয়েন্ট কল করুন।
  3. 3আপলোড সার্ভার এন্ডপয়েন্ট দিয়ে আপলোড সার্ভার চান এবং যে ঠিকানা আসে তা নোট করুন।
  4. 4ফাইলটি ওই ঠিকানায় মাল্টিপার্ট ফর্ম ডেটা হিসেবে পোস্ট করুন। উত্তরে ফাইল কোড, ওয়াচ লিংক ও এম্বেড লিংক থাকে।
  5. 5প্রসেসিং কখন শেষ হয় দেখতে ফাইল চেক এন্ডপয়েন্ট পোল করুন বা ফাইল তালিকাভুক্ত করুন।

আসল এন্ডপয়েন্টসহ উদাহরণ

curl: অ্যাকাউন্ট তথ্য ও আপলোড

প্রথম কলে কী যাচাই হয়। দ্বিতীয়টি আপলোড সার্ভার কলে পাওয়া সার্ভার ঠিকানায় ফাইল পোস্ট করে।

curl "https://filehost.net/api/account/info?key=YOUR_API_KEY"

curl "https://filehost.net/api/upload/server?key=YOUR_API_KEY"

curl -X POST -F 'api_key=YOUR_API_KEY' -F '[email protected]' \
  "https://filehost.net/api/upload/server/01?key=YOUR_API_KEY"

PHP দিয়ে URL থেকে ভিডিও ইমপোর্ট

একটি রিমোট আপলোড জব যোগ করে ফাইল কোড প্রিন্ট করে। সোর্স ঠিকানায় urlencode ব্যবহার করুন।

<?php
$key = 'YOUR_API_KEY';
$src = urlencode('https://example.com/video.mp4');
$res = json_decode(file_get_contents(
    "https://filehost.net/api/upload/url?key=$key&url=$src"
), true);
echo $res['result']['filecode'] ?? 'failed';

JavaScript দিয়ে ফাইলের স্ট্যাটাস যাচাই

Node 18 বা পরের ভার্সনে এবং ব্রাউজারে চলে, যদি কী সার্ভার সাইডে রাখেন।

const key = process.env.FILEHOST_KEY;
const code = 'FILE_CODE';
const r = await fetch(
  `https://filehost.net/api/file/check?key=${key}&file_code=${code}`
);
const data = await r.json();
console.log(data.result[0].status);

ভালো অভ্যাস

কী ক্লায়েন্ট-সাইড কোডের বাইরে রাখুন, কারণ যে দেখে সে আপনার অ্যাকাউন্ট হিসেবে কাজ করতে পারে। কল কিউতে রেখে এবং 429 উত্তরে পিছিয়ে প্রতি সেকেন্ডে 10 রিকোয়েস্টের সীমা মানুন। আপলোডে ফেরত আসা ফাইল কোড সংরক্ষণ করুন, কারণ অন্য প্রতিটি কল ফাইলকে ওই কোড দিয়ে চেনে।

বড় আপলোড স্থির কানেকশনের সার্ভার থেকে পাঠানোই ভালো। অনলাইনে আগে থেকে থাকা ফাইলের জন্য URL ইমপোর্ট বেছে নিন, যা সার্ভারের কানেকশন ব্যবহার করে এবং সঙ্গে সঙ্গে জব কোড ফেরত দেয়।

বাস্তবে এরর হ্যান্ডলিং

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

API যা করে না

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

FileHost.net-এর তুলনা

ইন্টিগ্রেশনের জন্য হোস্ট যাচাই করছেন? প্রতিটি কী দেয় তা তুলনা করুন।

সব তুলনা দেখুন

সম্পর্কিত টুলস ও গাইড

ট্রাই করতে প্রস্তুত?

অ্যাকাউন্ট খুলুন, কী কপি করুন এবং প্রথম curl কমান্ড চালান। একই বিকেলেই কার্যকর ইন্টিগ্রেশন পাবেন।

সচরাচর জিজ্ঞাসিত প্রশ্ন

হ্যাঁ। প্রতিটি রিকোয়েস্ট আপনার ব্যক্তিগত কী ব্যবহার করে, যা অ্যাকাউন্ট সেটিংস থেকে কপি করা যায়।

প্রতি সেকেন্ডে দশটি রিকোয়েস্ট। সীমা ছাড়ালে 429 Too Many Requests উত্তর আসে।

হ্যাঁ। আপলোড সার্ভারের ঠিকানা চান, তারপর ফাইল মাল্টিপার্ট ফর্ম ডেটা হিসেবে সেখানে পোস্ট করুন।

হ্যাঁ। আপলোড URL এন্ডপয়েন্ট একটি লিংক নিয়ে ফাইল কোড ফেরত দেয়, ঐচ্ছিক ফোল্ডার ও শিরোনাম প্যারামিটারসহ।

PHP ও Python ক্লায়েন্ট শীঘ্রই আসছে বলে তালিকাভুক্ত। এখন সরাসরি HTTP এন্ডপয়েন্ট কল করুন।