واجهة API لاستضافة الفيديو للمطورين

ما تغطيه واجهة API

تحاكي الواجهة ما يمكنك فعله في لوحة التحكم. يمكنك قراءة تفاصيل الحساب والتخزين، وطلب خادم رفع وإرسال ملف، واستيراد فيديو من رابط، وعرض الملفات وفحصها ونقلها وتغيير أسمائها، وإنشاء مجلدات، والبحث في الفيديوهات، وإدارة طابور الرفع من رابط خارجي. وتتيح بضع إضافات إرفاق صورة افتتاحية أو ترجمات من عنوان بعيد.

الطلبات هي HTTP GET أو POST عادية. يوضع مفتاح API في معامل key ويوجد في إعدادات حسابك. كل رد بصيغة JSON يضم رسالة ورمز حالة ووقت الخادم ونتيجة. حالة الرد 429 تعني أنك بلغت حد 10 طلبات في الثانية؛ تواصل مع الدعم إن احتجت أكثر.

تكاملات شائعة

مسارات نشر ترسل فيديو مُصيَّرًا مباشرة من خادم البناء، وأدوات محتوى تستورد رابطًا من جدول بيانات، وإضافات تعرض مكتبة صانع محتوى على موقع، وسكربتات مراقبة تتابع حالة الترميز. عملاء PHP وPython الرسميون مدرجون كـ«قريبًا»، لذا تستدعي حاليًا نقاط النهاية مباشرة كما يظهر أدناه.

أجرِ أول استدعاء

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: استيراد فيديو من رابط

يضيف مهمة رفع من رابط خارجي ويطبع رمز الملف. استخدم 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);

ممارسات جيدة

أبقِ المفتاح خارج كود جهة العميل، لأن أي شخص يراه يستطيع التصرف باسم حسابك. والتزم بحد 10 طلبات في الثانية بوضع الطلبات في طابور والتراجع عند رد 429. واحفظ رمز الملف الذي يعيده الرفع، فكل طلب آخر يشير إلى الملف بهذا الرمز.

الأفضل إرسال الرفع الكبير من خادم باتصال مستقر. وللملفات الموجودة أصلًا على الإنترنت فضّل الاستيراد من رابط، فهو يستخدم اتصال الخادم ويعود فورًا برمز مهمة.

معالجة الأخطاء عمليًا

تحقق من حالة HTTP وحقل الحالة داخل جسم JSON معًا، وسجّل نص الرسالة الذي يشرح غالبًا ما حدث. اعتبر غياب رمز الملف أو انتهاء المفتاح فشلًا نهائيًا، ورد 429 إشارة للانتظار وإعادة المحاولة. وعند بناء مهام دفعية احتفظ بسجل محلي لكل رمز ملف يُعاد ليتمكن سكربت تعطل من الاستئناف دون رفع شيء مرتين.

ما لا تفعله واجهة API

لا توجد استدعاءات Webhook موثقة، لذا يُتحقق من الاكتمال بالاستعلام الدوري. يعطي رد الرفع الموثق رمز الملف والروابط، ولم تُنشر مكتبات العملاء الرسمية بعد. وإن احتجت قدرة ناقصة فأخبر الدعم عبر صفحة التواصل.

مقارنة FileHost.net بغيره

تقيّم استضافات لتكامل ما؟ قارن ما تتيحه كل منها.

عرض كل المقارنات

أدوات وأدلة ذات صلة