API کیا کچھ کور کرتی ہے

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

درخواستیں سادہ HTTP GET یا POST ہوتی ہیں۔ آپ کی API کی key پیرامیٹر میں جاتی ہے اور اکاؤنٹ سیٹنگز میں ملتی ہے۔ ہر جواب JSON ہوتا ہے جس میں پیغام، اسٹیٹس کوڈ، سرور ٹائم اور نتیجہ شامل ہوتا ہے۔ جوابی اسٹیٹس 429 کا مطلب ہے کہ آپ 10 درخواستیں فی سیکنڈ کی حد تک پہنچ گئے ہیں؛ مزید کی ضرورت ہو تو سپورٹ سے رابطہ کریں۔

عام انٹیگریشنز

پبلشنگ ورک فلوز جو رینڈر کی گئی ویڈیو براہِ راست بلڈ سرور سے بھیجتے ہیں، کنٹینٹ ٹولز جو اسپریڈ شیٹ سے لنک امپورٹ کرتے ہیں، پلگ اِنز جو سائٹ پر تخلیق کار کی لائبریری دکھاتے ہیں، اور مانیٹرنگ اسکرپٹس جو انکوڈنگ اسٹیٹس پر نظر رکھتے ہیں۔ سرکاری PHP اور Python کلائنٹس جلد آنے والے کے طور پر درج ہیں، اس لیے فی الحال نیچے دکھائے گئے طریقے سے اینڈ پوائنٹس کو براہِ راست کال کریں۔

اینڈ پوائنٹ گروپس

دستاویزی طریقوں کا خلاصہ۔

اکاؤنٹ

پروفائل، بیلنس اور اسٹوریج پڑھیں، تاریخوں کی حد کے لیے رپورٹنگ اعداد و شمار لیں اور DMCA نوٹسز کی فہرست دیکھیں۔

اپ لوڈ

اپ لوڈ سرور مانگیں، پھر فائل کو ملٹی پارٹ فارم ڈیٹا کے طور پر پوسٹ کریں اور کوڈز اور لنکس واپس پائیں۔

ریموٹ اپ لوڈ

URL شامل کریں، جابز کی فہرست دیکھیں، اسٹیٹس اور سلاٹس چیک کریں، اور ناکام امپورٹس دوبارہ شروع یا صاف کریں۔

فولڈرز

فولڈرز اور ان کی فائلیں بنائیں، نام بدلیں اور ان کی فہرست دیکھیں۔

فائلیں

فائلوں کی فہرست دیکھیں، چیک کریں، معائنہ کریں، نام بدلیں، منتقل اور کلون کریں اور تھمب نیلز لیں۔

تلاش

تلاش کے لفظ سے ویڈیوز ڈھونڈیں اور URLs سے اسپلیش امیجز یا سب ٹائٹلز منسلک کریں۔

اپنی پہلی کال کریں

  1. 1لاگ اِن کریں اور اکاؤنٹ سیٹنگز صفحے سے اپنی API Key کاپی کریں۔
  2. 2اکاؤنٹ انفو اینڈ پوائنٹ کال کر کے تصدیق کریں کہ Key کام کرتی ہے اور اپنا اسٹوریج اور بیلنس دیکھیں۔
  3. 3اپ لوڈ سرور اینڈ پوائنٹ سے اپ لوڈ سرور مانگیں اور جو ایڈریس ملے اسے نوٹ کر لیں۔
  4. 4فائل کو اس ایڈریس پر ملٹی پارٹ فارم ڈیٹا کے طور پر پوسٹ کریں۔ جواب میں فائل کوڈ، دیکھنے کا لنک اور ایمبیڈ لنک شامل ہوتا ہے۔
  5. 5فائل چیک اینڈ پوائنٹ کو پول کریں، یا فائلوں کی فہرست دیکھیں، تاکہ پتا چلے کہ پروسیسنگ کب ختم ہوئی۔

حقیقی اینڈ پوائنٹس کے ساتھ مثالیں

curl: اکاؤنٹ کی معلومات اور اپ لوڈ

پہلی کال Key کو جانچتی ہے۔ دوسری فائل کو اپ لوڈ سرور کال سے ملنے والے سرور ایڈریس پر پوسٹ کرتی ہے۔

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 یا اس کے بعد اور براؤزر میں کام کرتا ہے، بشرطیکہ Key کو سرور کی طرف رکھیں۔

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);

اچھا طریقہ

Key کو کلائنٹ سائیڈ کوڈ سے باہر رکھیں، کیونکہ جو بھی اسے دیکھ لے آپ کے اکاؤنٹ کے طور پر کام کر سکتا ہے۔ کالز کو قطار میں لگا کر اور 429 جواب پر رک کر فی سیکنڈ 10 درخواستوں کی حد کا احترام کریں۔ اپ لوڈ سے ملنے والا فائل کوڈ محفوظ کریں، کیونکہ باقی ہر کال فائل کو اسی کوڈ سے پہچانتی ہے۔

بڑے اپ لوڈ مستحکم کنیکشن والے سرور سے بھیجنا بہتر ہے۔ جو فائلیں پہلے سے آن لائن موجود ہیں ان کے لیے URL امپورٹ کو ترجیح دیں، جو سرور کا کنیکشن استعمال کرتا ہے اور جاب کوڈ کے ساتھ فوراً واپس آ جاتا ہے۔

عملی طور پر ایرر ہینڈلنگ

HTTP اسٹیٹس اور JSON باڈی کے اندر موجود اسٹیٹس فیلڈ دونوں جانچیں، اور میسج کا متن لاگ کریں جو عموماً بتاتا ہے کہ کیا غلط ہوا۔ فائل کوڈ کی غیر موجودگی یا Key کی میعاد ختم ہونے کو سنگین ناکامی سمجھیں، اور 429 جواب کو انتظار کر کے دوبارہ کوشش کرنے کا اشارہ۔ بیچ جابز بناتے وقت ہر واپس ملنے والے فائل کوڈ کا مقامی ریکارڈ رکھیں تاکہ کریش ہونے والا اسکرپٹ کچھ دوبارہ اپ لوڈ کیے بغیر جاری رہ سکے۔

API کیا نہیں کرتی

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

FileHost.net کا موازنہ

انٹیگریشن کے لیے ہوسٹس کا جائزہ لے رہے ہیں؟ دیکھیں کہ ہر ایک کیا فراہم کرتا ہے۔

تمام موازنے دیکھیں

متعلقہ ٹولز اور گائیڈز

آزمانے کو تیار ہیں؟

اکاؤنٹ بنائیں، اپنی Key کاپی کریں اور پہلی curl کمانڈ چلائیں۔ اسی دوپہر آپ کے پاس کام کرتی ہوئی انٹیگریشن ہوگی۔

اکثر پوچھے جانے والے سوالات

جی ہاں۔ ہر درخواست آپ کی ذاتی Key استعمال کرتی ہے، جسے آپ اپنی اکاؤنٹ سیٹنگز سے کاپی کر سکتے ہیں۔

فی سیکنڈ دس درخواستیں۔ حد سے بڑھنے پر 429 Too Many Requests جواب ملتا ہے۔

جی ہاں۔ اپ لوڈ سرور کا ایڈریس مانگیں، پھر فائل کو ملٹی پارٹ فارم ڈیٹا کے طور پر اس پر پوسٹ کریں۔

جی ہاں۔ اپ لوڈ URL اینڈ پوائنٹ لنک لیتا ہے اور فائل کوڈ واپس کرتا ہے، فولڈر اور عنوان کے اختیاری پیرامیٹرز کے ساتھ۔

PHP اور Python کلائنٹس جلد آنے والے کے طور پر درج ہیں۔ فی الحال HTTP اینڈ پوائنٹس کو براہِ راست کال کریں۔