डेवलपर्स के लिए वीडियो होस्टिंग API

API क्या-क्या कवर करती है

यह इंटरफ़ेस वही दिखाता है जो आप डैशबोर्ड में कर सकते हैं। आप अकाउंट विवरण और स्टोरेज पढ़ सकते हैं, अपलोड सर्वर मांगकर फ़ाइल भेज सकते हैं, URL से वीडियो इम्पोर्ट कर सकते हैं, फ़ाइलें सूचीबद्ध और जांच सकते हैं, ले जा और नाम बदल सकते हैं, फ़ोल्डर बना सकते हैं, वीडियो खोज सकते हैं और रिमोट अपलोड कतार संभाल सकते हैं। कुछ अतिरिक्त सुविधाएं रिमोट पते से स्प्लैश इमेज या सबटाइटल जोड़ने देती हैं।

रिक्वेस्ट सादे 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: 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 की तुलना कैसी है

किसी इंटीग्रेशन के लिए होस्ट परख रहे हैं? तुलना करें कि हर एक क्या उपलब्ध कराता है।

सभी तुलनाएं देखें

संबंधित टूल और गाइड