Pandafile · Miễn phí 50 GB mỗi tuần

API chuyển file cho ứng dụng và quy trình của bạn

Pandafile có REST API để gửi file lớn từ chính mã nguồn, máy chủ và công cụ no-code của bạn. Tạo lượt chuyển, tải file lên với cơ chế tải lên tiếp tục được, gửi link riêng cho người nhận qua email và nhận webhook khi có người tải về. API thuộc gói Pro và Team, tuân theo cùng giới hạn như ứng dụng web và được mô tả trong một tài liệu OpenAPI 3.1 công khai. Khóa test cho phép bạn xây dựng và chạy thử mà không gửi email thật hay dùng dung lượng lưu trữ của bạn.

Đọc hướng dẫn cho nhà phát triển

REST API với mô tả OpenAPI 3.1

Mọi endpoint đều nằm dưới /api/v1 và dùng JSON. Bạn xác thực bằng khóa API trong header Authorization dưới dạng Bearer token. Khóa được tạo trong bảng điều khiển, chỉ hiển thị một lần và có thể giới hạn ở quyền chỉ đọc, đọc và ghi, hoặc toàn quyền, nên một script báo cáo sẽ không bao giờ có quyền xóa lượt chuyển. Toàn bộ API được mô tả trong tài liệu OpenAPI 3.1 mà máy đọc được tại /api/v1/openapi.json, bạn có thể nạp vào Postman, sinh client từ đó hoặc đưa cho trợ lý lập trình AI. Hướng dẫn cho nhà phát triển tại /developers giải thích các khái niệm, còn tài liệu tham khảo API tại /developers/api liệt kê mọi endpoint kèm ví dụ. Mỗi phản hồi đều có request ID, giới hạn tần suất được báo trong header RateLimit, danh sách dùng phân trang theo cursor, và mọi lỗi dùng chung một định dạng JSON.

Tải lên tiếp tục được với tus

File lớn và mạng chập chờn không hợp với một HTTP request dài duy nhất. Để gửi file, trước tiên bạn tạo lượt chuyển bằng POST /api/v1/transfers, liệt kê các file, tiêu đề, lời nhắn và, nếu muốn, địa chỉ email người nhận. Sau đó mỗi file được tải lên bằng tus, giao thức mở cho việc tải lên tiếp tục được, nên khi mất kết nối hay máy chủ khởi động lại, quá trình sẽ chạy tiếp từ byte cuối cùng thay vì bắt đầu lại. Đã có sẵn tus client cho JavaScript, Python, Go, Java, .NET, Swift và nhiều ngôn ngữ khác. Khi mọi file đã lên đủ, bạn gọi complete, và lượt chuyển trở thành một link Pandafile bình thường với trang tải về, link riêng cho người nhận, lời nhắc và thời hạn. Giới hạn của gói giống hệt như trên trình duyệt: đến 1000 GB mỗi lượt chuyển và 1500 GB dung lượng lưu trữ với Pro.

Gửi file trực tiếp từ URL

Đôi khi file đã nằm ở nơi khác: file đính kèm trong CRM, kết quả từ render farm hay file export trên một máy chủ khác. POST /api/v1/transfers/from-url nhận các URL HTTPS và để Pandafile lấy file giúp bạn, rồi tạo và hoàn tất lượt chuyển. Request chờ tối đa 20 giây. Lượt nhập nhỏ trả về khi đã xong, còn lượt nhập lớn trả về ngay với trạng thái uploading trong khi quá trình nhập tiếp tục chạy nền. Bạn có thể theo dõi tiến độ bằng GET /api/v1/transfers/{id}/import, hoặc đơn giản là chờ webhook transfer.ready. Đây cũng là cách các tích hợp Zapier và Make gửi file mà quy trình của bạn không cần tải file về trước.

Webhook và thông báo

Thay vì hỏi liên tục (polling), hãy đăng ký nhận sự kiện. Pandafile có thể gọi URL của bạn khi một lượt chuyển sẵn sàng, được tải về hoặc hết hạn, khi người nhận phê duyệt file hoặc yêu cầu chỉnh sửa, khi có người tải lên một trong các yêu cầu file của bạn và khi một yêu cầu ký được hoàn tất. Mỗi lần gửi đều được ký bằng HMAC-SHA256 trong header Pandafile-Signature, để bạn kiểm tra được nó thực sự đến từ chúng tôi, và các lần gửi thất bại được thử lại sau 1 phút, 5 phút, 30 phút, 2 giờ và 12 giờ. Sự kiện còn được lưu 30 ngày và có thể đọc bằng GET /api/v1/events. Nếu bạn không cần viết code, các sự kiện này cũng có thể gửi tin nhắn đến Slack, Microsoft Teams hoặc Discord.

Khóa test, thử lại an toàn và những gì khác có thể tự động hóa

Khóa API có hai chế độ. Khóa live bắt đầu bằng pf_live_ và khóa test bắt đầu bằng pf_test_. Lượt chuyển tạo bằng khóa test không bao giờ gửi email, không tính vào dung lượng lưu trữ hay mức sử dụng của bạn, chỉ được giữ 24 giờ và không hiện trong danh sách lượt chuyển thông thường, nên bạn có thể chạy kiểm thử tích hợp với API thật mà không có tác dụng phụ. Request POST và PATCH chấp nhận header Idempotency-Key, nên một request được gửi lại không bao giờ tạo ra lượt chuyển thứ hai. Ngoài lượt chuyển, API còn bao gồm người nhận và lời nhắc, lịch sử tải về, thống kê link và phê duyệt, yêu cầu file, yêu cầu ký, thương hiệu và lời mời vào nhóm. API có trong Pro, từ $5.99 mỗi tháng hoặc $49.99 mỗi năm, và Team, từ $14.99 mỗi tháng hoặc $129.99 mỗi năm. Trong một nhóm, mỗi thành viên có khóa cá nhân riêng.

Câu hỏi

Pandafile có API không?

Có. Pandafile có REST API dưới /api/v1 để tạo lượt chuyển, tải file lên, quản lý người nhận, yêu cầu file và yêu cầu ký, cũng như nhận webhook. API có trong gói Pro và Team.

Tài liệu API ở đâu?

Hướng dẫn cho nhà phát triển ở /developers và tài liệu tham khảo API đầy đủ kèm ví dụ ở /developers/api. Tài liệu OpenAPI 3.1 mà máy đọc được được công khai tại /api/v1/openapi.json.

Tải lên có tiếp tục được khi mất kết nối không?

Có. File được tải lên bằng giao thức tus cho việc tải lên tiếp tục được, nên một lần tải lên bị gián đoạn sẽ chạy tiếp từ chỗ đã dừng thay vì bắt đầu lại.

Tôi có thể thử nghiệm mà không gửi email thật không?

Có. Hãy dùng khóa test bắt đầu bằng pf_test_. Lượt chuyển test không bao giờ gửi email, không tính vào dung lượng lưu trữ hay mức sử dụng của bạn và bị xóa sau 24 giờ.

Tôi có thể gửi một file đã có sẵn trên mạng không?

Có. POST /api/v1/transfers/from-url lấy file từ các URL HTTPS và biến chúng thành một lượt chuyển. Lượt nhập lớn tiếp tục chạy nền, và webhook transfer.ready báo cho bạn khi link đã sẵn sàng.

Đọc hướng dẫn cho nhà phát triển

Phổ biến