Cakupan API

Antarmukanya mencerminkan apa yang bisa Anda lakukan di dasbor. Anda bisa membaca detail akun dan penyimpanan, meminta server unggah dan mengirim file, mengimpor video dari URL, mendaftar dan memeriksa file, memindah dan mengganti nama file, membuat folder, mencari video, dan mengelola antrean unggah jarak jauh. Beberapa tambahan memungkinkan Anda melampirkan gambar splash atau subtitle dari alamat remote.

Permintaan berupa HTTP GET atau POST biasa. Kunci API Anda dikirim lewat parameter key dan dapat ditemukan di pengaturan akun. Setiap balasan berupa JSON berisi pesan, kode status, waktu server, dan hasil. Status respons 429 berarti Anda mencapai batas 10 permintaan per detik; hubungi dukungan jika membutuhkan lebih banyak.

Integrasi umum

Alur publikasi yang mengirim video hasil render langsung dari build server, alat konten yang mengimpor tautan dari spreadsheet, plugin yang menampilkan pustaka kreator di sebuah situs, dan skrip pemantauan yang mengawasi status encoding. Klien PHP dan Python resmi tercantum segera hadir, jadi untuk saat ini Anda memanggil endpoint secara langsung seperti contoh di bawah.

Grup endpoint

Ringkasan metode yang terdokumentasi.

Akun

Baca profil, saldo, dan penyimpanan, ambil statistik laporan per rentang tanggal, dan daftar pemberitahuan DMCA.

Unggah

Minta server unggah, lalu kirim file sebagai multipart form data dan terima kode serta tautan.

Unggah remote

Tambahkan URL, daftar tugas, cek status dan slot, serta mulai ulang atau hapus impor yang gagal.

Folder

Buat, ganti nama, dan daftar folder beserta file di dalamnya.

File

Daftar, cek, periksa, ganti nama, pindah, dan duplikat file serta ambil thumbnail-nya.

Cari

Cari video dengan kata kunci dan lampirkan gambar splash atau subtitle dari URL.

Buat panggilan pertama Anda

  1. 1Masuk dan salin kunci API Anda dari halaman pengaturan akun.
  2. 2Panggil endpoint info akun untuk memastikan kunci berfungsi dan melihat penyimpanan serta saldo Anda.
  3. 3Minta server unggah dengan endpoint server unggah dan catat alamat yang dikembalikan.
  4. 4Kirim file ke alamat itu sebagai multipart form data. Balasannya mencakup kode file, tautan tonton, dan tautan embed.
  5. 5Polling endpoint cek file, atau daftar file, untuk melihat kapan pemrosesan selesai.

Contoh dengan endpoint nyata

curl: info akun dan unggah

Panggilan pertama memeriksa kunci. Panggilan kedua mengirim file ke alamat server yang dikembalikan oleh panggilan server unggah.

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: impor video dari URL

Menambahkan tugas unggah jarak jauh dan menampilkan kode file. Gunakan urlencode pada alamat sumber.

<?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 – cek status file

Berfungsi di Node 18 atau lebih baru dan di browser, selama kunci tetap disimpan di sisi server.

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

Praktik terbaik

Jauhkan kunci dari kode sisi klien, karena siapa pun yang melihatnya bisa bertindak sebagai akun Anda. Patuhi batas 10 permintaan per detik dengan mengantrekan panggilan dan menunggu saat ada balasan 429. Simpan kode file yang dikembalikan oleh unggahan, karena setiap panggilan lain merujuk ke file lewat kode itu.

Unggahan besar paling baik dikirim dari server dengan koneksi stabil. Untuk file yang sudah ada online, pilih impor URL, yang memakai koneksi server dan langsung mengembalikan kode tugas.

Penanganan error dalam praktik

Periksa status HTTP dan juga kolom status di dalam isi JSON, serta catat teks pesannya, yang biasanya menjelaskan apa yang salah. Anggap kode file yang hilang atau kunci yang kedaluwarsa sebagai kegagalan fatal, dan balasan 429 sebagai sinyal untuk menunggu lalu mencoba lagi. Saat membuat tugas batch, simpan catatan lokal setiap kode file yang dikembalikan agar skrip yang crash bisa dilanjutkan tanpa mengunggah apa pun dua kali.

Yang tidak bisa dilakukan API

Tidak ada callback webhook yang didokumentasikan, jadi penyelesaian proses diperiksa dengan polling. Respons unggahan yang didokumentasikan memberikan kode file dan tautan, dan pustaka klien resmi belum dirilis. Jika Anda memerlukan fitur yang belum ada, beri tahu dukungan lewat halaman kontak.

Perbandingan FileHost.net

Sedang menilai host untuk integrasi? Bandingkan apa yang disediakan masing-masing.

Lihat semua perbandingan

Alat dan panduan terkait

Siap mencobanya?

Buat akun, salin kunci Anda, dan jalankan perintah curl pertama. Integrasi Anda sudah berfungsi di sore yang sama.

Pertanyaan yang sering diajukan

Ya. Setiap permintaan memakai kunci pribadi Anda, yang bisa disalin dari pengaturan akun.

Sepuluh permintaan per detik. Jika melebihinya, balasannya 429 Too Many Requests.

Ya. Minta alamat server unggah, lalu kirim file ke sana sebagai multipart form data.

Ya. Endpoint unggah URL menerima tautan dan mengembalikan kode file, dengan parameter folder dan judul opsional.

Klien PHP dan Python tercantum segera hadir. Untuk saat ini, panggil endpoint HTTP secara langsung.