API phương tiệnAPI

Tải lên một lần, đăng ở mọi nơi

Gửi tệp vào thư viện phương tiện và nhận lại một id. Đính kèm id đó vào bao nhiêu bài đăng cũng được, FoPost sẽ chuyển đổi và gửi đi theo đúng dạng mỗi mạng yêu cầu. Lưu trữ riêng tư và giới hạn trong không gian làm việc.

POST /v1/media/upload
curl -X POST "https://api.fopost.com/v1/media/upload?workspace_id=9b2f6c1e-..." \
  -H "X-API-Key: $API_KEY" \
  -F "[email protected]"

{
  "data": [
    {
      "id": "e5a1c9d4-...",
      "type": "image",
      "name": "launch.png",
      "url": "https://.../launch.png",
      "preview_url": "https://api.fopost.com/v1/media/e5a1c9d4-.../file",
      "size": 412883
    }
  ]
}

Tải lên multipart

Ảnh và video tối đa 50 MB, được kiểm tra theo nội dung chứ không chỉ theo phần mở rộng.

Dùng lại theo id

Một lần tải lên, bao nhiêu bài đăng cũng được. Tệp không bao giờ bị gửi hai lần.

Mặc định riêng tư

Tệp nằm trong kho lưu trữ riêng tư và chỉ được cung cấp cho thành viên của không gian làm việc.

Tải lên

Một đường vào duy nhất, kiểm tra ngay khi đến

Mọi tệp đều đi qua cùng một đường: danh sách MIME được phép, kiểm tra byte thực tế, giới hạn kích thước và hạn mức lưu trữ miễn phí của tài khoản bạn. Kết quả trả về là một mục trong thư viện kèm loại và kích thước, sẵn sàng để đính kèm.

Đọc tài liệu tham khảo về phương tiện
Đính kèm vào bài đăng
curl -X POST https://api.fopost.com/v1/posts \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "content": [{ "text": "Launch day.", "media": [{ "type": "image", "name": "launch.png", "url": "https://.../launch.png" }] }],
    "accounts": ["4a71d80b-..."]
  }'

Ảnh

PNG, JPEG, GIF và WebP, với loại và kích thước được đọc khi tải lên.

Video

MP4 và MOV, với thời lượng và kích thước được kiểm tra theo từng mạng lúc đăng.

Đã xác thực

Nội dung thực của tệp phải khớp với loại của nó, nếu không lần tải lên sẽ bị từ chối.

Gửi đi

Đúng định dạng cho từng mạng, đã làm sẵn cho bạn

Các mạng không thống nhất về tỷ lệ khung hình, kích thước và codec. Lúc đăng, mỗi adapter lấy bản gốc đã lưu và tải lên đúng thứ nền tảng đó chấp nhận, nên một tài nguyên trong thư viện dùng được cho carousel, chuỗi bài lẫn nguồn cấp video ngắn.

Xem cách gửi hoạt động
Hình ảnh thương hiệu được sắp xếp trong thư viện phương tiện dùng chung

Quy tắc theo từng mạng

Giới hạn kích thước và định dạng do adapter áp dụng, không phải bạn.

Phương tiện có thứ tự

Thứ tự trong khối nội dung chính là thứ tự của carousel.

Lỗi rõ ràng

Tệp mà một mạng không nhận được chỉ làm thất bại lượt gửi đó kèm lý do, không phải cả bài đăng.

Quản lý

Duyệt, lấy và dùng lại thư viện

Liệt kê thư viện với bộ lọc, lấy bất kỳ tài nguyên nào qua endpoint tệp vốn kiểm tra quyền thành viên không gian làm việc ở mỗi yêu cầu và không bao giờ hết hạn, rồi tham chiếu cùng một id từ bao nhiêu bài đăng tùy ý. Tài nguyên thương hiệu, nội dung nhập và ảnh được tạo đều nằm chung một thư viện.

Bắt đầu xây dựng
GET /v1/media
curl "https://api.fopost.com/v1/media?workspace_id=9b2f6c1e-...&type=image" \
  -H "X-API-Key: $API_KEY"

# Fetch the file itself
curl -L "https://api.fopost.com/v1/media/e5a1c9d4-.../file" \
  -H "X-API-Key: $API_KEY" -o launch.png

Liệt kê và lọc

Theo loại, nguồn gốc hoặc vai trò thương hiệu, có phân trang.

URL tệp cố định

/v1/media/:id/file always works for members; no signed links to refresh.

Giới hạn trong không gian làm việc

Một khóa chỉ thấy thư viện của một không gian làm việc, không gì khác.

Giải đáp câu hỏi về API phương tiện

Giới hạn kích thước là bao nhiêu?

50 MB mỗi tệp. Từng mạng có giới hạn riêng, và các giới hạn đó được kiểm tra khi bài đăng được gửi đến mạng tương ứng.

Những định dạng nào được chấp nhận?

Các định dạng ảnh phổ biến (PNG, JPEG, GIF, WebP) và video (MP4, MOV). Lần tải lên kiểm tra byte thực tế của tệp, nên tệp chỉ đổi tên sẽ bị từ chối.

Tôi có thể đính kèm một media id vào nhiều bài đăng không?

Có. Đó chính là mục đích của thư viện. Tải lên một lần và tham chiếu id từ bất kỳ bài đăng nào trong không gian làm việc.

Tệp đã tải lên có công khai không?

Không. Lưu trữ là riêng tư. Endpoint tệp kiểm tra quyền thành viên không gian làm việc ở mỗi yêu cầu, và các mạng chỉ nhận một liên kết ngắn hạn vào lúc đăng.

Nó có bị tính vào hạn mức không?

Có, mọi tài khoản đều có hạn mức lưu trữ miễn phí, và phần lưu trữ vượt quá được tính theo GB mỗi tháng khi đã lưu thẻ. Mọi lần tải lên, nhập và ảnh được tạo đều được tính theo cùng một cách.

Tôi có thể nhập từ URL hoặc công cụ thiết kế không?

Có, nội dung nhập đi vào cùng thư viện và mang theo tham chiếu nguồn, nên bạn có thể kéo lại thiết kế đã cập nhật ngay tại chỗ thay vì tải lên tệp mới.

Xây dựng trên API phương tiện ngay hôm nay

Bắt đầu miễn phí và đã bao gồm đầy đủ API. Tạo khóa và thực hiện lệnh gọi đầu tiên chỉ trong vài phút.

Lấy khóa API