Đăng nhập
Giao diện phản ánh những gì bạn làm được trong bảng điều khiển. Bạn có thể đọc thông tin tài khoản và dung lượng lưu trữ, yêu cầu máy chủ tải lên và gửi tệp, nhập video từ URL, liệt kê và xem chi tiết tệp, di chuyển và đổi tên, tạo thư mục, tìm kiếm video và quản lý hàng đợi tải lên từ xa. Một vài tính năng bổ sung cho phép đính kèm ảnh bìa hoặc phụ đề từ một địa chỉ từ xa.
Yêu cầu là HTTP GET hoặc POST thông thường. Khóa API của bạn nằm trong tham số key và có trong phần cài đặt tài khoản. Mọi phản hồi đều là JSON gồm thông báo, mã trạng thái, giờ máy chủ và kết quả. Trạng thái phản hồi 429 nghĩa là bạn đã chạm giới hạn 10 yêu cầu mỗi giây; hãy liên hệ bộ phận hỗ trợ nếu cần thêm.
Quy trình xuất bản đẩy thẳng video đã render từ máy chủ build, công cụ nội dung nhập liên kết từ bảng tính, plugin liệt kê thư viện của người sáng tạo trên website và script giám sát theo dõi trạng thái mã hóa. Thư viện PHP và Python chính thức được liệt kê là sắp ra mắt, nên hiện tại bạn gọi trực tiếp các endpoint như minh họa bên dưới.
Tóm tắt các phương thức đã có tài liệu.
Đọc hồ sơ, số dư và dung lượng lưu trữ, lấy thống kê báo cáo theo khoảng ngày và liệt kê thông báo DMCA.
Yêu cầu một máy chủ tải lên, rồi gửi tệp dạng multipart form data và nhận lại mã cùng liên kết.
Thêm URL, liệt kê tác vụ, kiểm tra trạng thái và slot, khởi động lại hoặc xóa các lần nhập lỗi.
Tạo, đổi tên và liệt kê thư mục cùng các tệp bên trong.
Liệt kê, kiểm tra, xem chi tiết, đổi tên, di chuyển, nhân bản tệp và lấy hình thu nhỏ của chúng.
Tìm video theo từ khóa và đính kèm ảnh bìa hoặc phụ đề từ URL.
Lệnh gọi đầu tiên kiểm tra khóa. Lệnh thứ hai gửi tệp tới địa chỉ máy chủ do lệnh gọi máy chủ tải lên trả về.
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"Thêm tác vụ tải lên từ xa và in ra mã tệp. Dùng urlencode cho địa chỉ nguồn.
<?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';Chạy được trên Node 18 trở lên và trong trình duyệt, miễn là bạn giữ khóa ở phía máy chủ.
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);Đừng để khóa trong mã phía client, vì ai thấy nó cũng có thể hành động như tài khoản của bạn. Tuân thủ giới hạn 10 yêu cầu mỗi giây bằng cách xếp hàng các lệnh gọi và giãn cách khi nhận phản hồi 429. Lưu mã tệp mà lần tải lên trả về, vì mọi lệnh gọi khác đều tham chiếu tệp bằng mã đó.
Tải lên lớn nên gửi từ máy chủ có kết nối ổn định. Với tệp đã có sẵn trực tuyến, nên dùng nhập từ URL, dùng kết nối của máy chủ và trả về ngay với mã tác vụ.
Hãy kiểm tra cả mã trạng thái HTTP lẫn trường status trong nội dung JSON, và ghi log nội dung thông báo, thường giải thích điều gì đã sai. Coi việc thiếu mã tệp hoặc khóa hết hạn là lỗi nghiêm trọng, còn phản hồi 429 là tín hiệu để chờ và thử lại. Khi xây dựng tác vụ hàng loạt, hãy lưu cục bộ mọi mã tệp được trả về để script bị lỗi có thể tiếp tục mà không tải lên lại lần nào.
Hiện chưa có tài liệu về webhook callback, nên việc hoàn tất được kiểm tra bằng cách thăm dò (polling). Phản hồi tải lên trong tài liệu trả về mã tệp và các liên kết, còn thư viện máy khách chính thức vẫn chưa được phát hành. Nếu bạn cần một tính năng còn thiếu, hãy báo cho bộ phận hỗ trợ qua trang liên hệ.
Đang đánh giá dịch vụ để tích hợp? Hãy so sánh những gì mỗi bên cung cấp.
Tạo tài khoản, sao chép khóa và chạy lệnh curl đầu tiên. Bạn sẽ có tích hợp hoạt động ngay trong buổi chiều.