Media APIAPI

Bir kez yükleyin, her yerde yayınlayın

Medya kütüphanesine bir dosya gönderin ve bir kimlik alın. Bu kimliği istediğiniz sayıda gönderiye ekleyin; FoPost dosyayı her ağın istediği biçime dönüştürüp teslim eder. Depolama özeldir ve çalışma alanıyla sınırlıdır.

API Anahtarını Al Belgeleri Okuyun

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
    }
  ]
}

Çok parçalı yükleme

50 MB'a kadar görseller ve videolar; yalnızca uzantıya göre değil, içeriğe göre doğrulanır.

Kimlikle yeniden kullanın

Tek yükleme, istediğiniz sayıda gönderi. Dosya asla iki kez gönderilmez.

Varsayılan olarak özel

Dosyalar özel depolamada durur ve yalnızca çalışma alanı üyelerine sunulur.

Yükle

Tek giriş yolu, varışta kontrol

Her dosya aynı yoldan geçer: MIME izin listesi, gerçek baytların kontrolü, bir boyut sınırı ve hesabınızın ücretsiz depolama kotası. Geri dönen şey, türü ve boyutuyla eklemeye hazır bir kütüphane kaydıdır.

Medya Referansını Okuyun

Gönderiye ekleyin

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-..."]
  }'

Görseller

PNG, JPEG, GIF ve WebP; tür ve boyut yükleme sırasında okunur.

Video

MP4 ve MOV; süre ve boyut, yayın anında her ağa göre kontrol edilir.

Doğrulanmış

Dosyanın gerçek içeriği türüyle eşleşmelidir, aksi halde yükleme reddedilir.

Teslim et

Her ağ için doğru biçim, sizin yerinize

Ağlar en-boy oranları, boyutlar ve codec'ler konusunda farklı kurallara sahiptir. Yayın anında her bağdaştırıcı saklanan orijinali alır ve o platformun kabul ettiği şeyi yükler; böylece tek bir kütüphane öğesi karuselde, dizide ve kısa video akışında aynı şekilde çalışır.

Teslimatın Nasıl Çalıştığını Görün

Paylaşılan medya kütüphanesinde düzenlenmiş marka görselleri

Ağa özel kurallar

Boyut ve biçim sınırlarını siz değil, bağdaştırıcı uygular.

Sıralı medya

İçerik bloğundaki sıra, karuselin sırasıdır.

Net hatalar

Bir ağın kabul edemediği dosya, tüm gönderiyi değil yalnızca o teslimatı nedeniyle birlikte başarısız kılar.

Yönet

Kütüphaneye göz atın, öğeleri alın ve yeniden kullanın

Kütüphaneyi filtrelerle listeleyin, her istekte çalışma alanı üyeliğini kontrol eden ve süresi hiç dolmayan bir dosya uç noktasıyla istediğiniz öğeyi alın ve aynı kimliğe istediğiniz kadar gönderiden başvurun. Marka öğeleri, içe aktarmalar ve üretilen görseller aynı kütüphanede toplanır.

Geliştirmeye Başlayın

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

Listeleyin ve filtreleyin

Türe, kaynağa veya marka rolüne göre, sayfalamayla.

Kalıcı dosya URL'si

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

Çalışma alanı kapsamlı

Bir anahtar yalnızca tek bir çalışma alanının kütüphanesini görür, başka hiçbir şeyi değil.

Media API hakkında sorular ve yanıtlar

Boyut sınırı nedir?

Dosya başına 50 MB. Her ağın kendi üst sınırları vardır ve bunlar bir gönderi o ağa teslim edilirken kontrol edilir.

Hangi biçimler kabul ediliyor?

Yaygın görsel biçimleri (PNG, JPEG, GIF, WebP) ve video (MP4, MOV). Yükleme gerçek dosya baytlarını kontrol eder, bu yüzden adı değiştirilmiş bir dosya reddedilir.

Bir medya kimliğini birden fazla gönderiye ekleyebilir miyim?

Evet. Kütüphanenin amacı da bu. Bir kez yükleyin ve çalışma alanındaki herhangi bir gönderiden kimliğe başvurun.

Yüklenen dosyalar herkese açık mı?

Hayır. Depolama özeldir. Dosya uç noktası her istekte çalışma alanı üyeliğini kontrol eder ve ağlar yalnızca yayın anında kısa ömürlü bir bağlantı alır.

Bir kotadan düşüyor mu?

Evet, her hesapta ücretsiz bir depolama kotası bulunur ve bunun ötesindeki depolama, kayıtlı bir kartla aylık GB başına ölçülür. Her yükleme, içe aktarma ve üretilen görsel bu kotaya aynı şekilde sayılır.

Bir URL'den veya tasarım aracından içe aktarabilir miyim?

Evet, içe aktarmalar aynı kütüphaneye gelir ve bir kaynak referansı taşır; böylece yeni bir dosya yüklemek yerine güncellenmiş bir tasarımı yerinde yeniden çekebilirsiniz.

Media API ile bugün geliştirmeye başlayın

Başlamak ücretsizdir ve eksiksiz API dahildir. Bir anahtar oluşturun ve ilk çağrınızı dakikalar içinde yapın.

API Anahtarını Al