Paylaşım API'siAPI

Her yerde yayınlamak için tek POST

Gönderiyi bir kez oluşturun, ulaşması gereken hesapları listeleyin; FoPost her ağ için biçimlendirmeyi, medya yüklemeyi ve teslimatı üstlenir. Kapsamlı anahtarlar, idempotent istekler ve sorgulayabileceğiniz ya da webhook ile alabileceğiniz teslim durumu.

API Anahtarını Al Belgeleri Okuyun

POST /v1/posts

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": "Shipped a new release today." }],
    "accounts": ["4a71d80b-...", "c30e9f12-..."]
  }'

curl -X POST https://api.fopost.com/v1/posts/7d3e0a52-.../publish \
  -H "X-API-Key: $API_KEY"

Her ağ, tek yapı

Aynı istek gövdesi X, LinkedIn, Instagram ve diğer tüm bağlı hesaplarda yayınlar.

Kapsamlı anahtarlar

publish kapsamına sahip bir anahtar gönderi paylaşabilir, başka hiçbir şey yapamaz. Diğerlerine dokunmadan iptal edin.

Hesap başına teslimat

Her hesap, yayına girdiğinde kendi durumunu, harici kimliğini ve kalıcı bağlantısını bildirir.

Yayınla

Gönderiyi bir kez yazın, istediğiniz hesapları hedefleyin

Metni, medyayı ve ulaşılacak hesapları gönderin. FoPost her ağın sınırlarını ve kurallarını uygular, medyayı platformun istediği biçimde yükler ve takip edebileceğiniz bir gönderi kimliği döndürür. Diziler, karuseller ve uzun metinler aynı içerik dizisi üzerinden ilerler.

Paylaşım Referansını Okuyun

Yanıt

{
  "post_status": "publishing",
  "deliveries": [
    { "id": "a3c5e7f9-...", "account_id": "4a71d80b-...", "status": "queued", "external_url": null, "posted_at": null, "attempts": 0 },
    { "id": "b4d6f8a0-...", "account_id": "c30e9f12-...", "status": "queued", "external_url": null, "posted_at": null, "attempts": 0 }
  ],
  "health_warnings": []
}

İçerik blokları

Sıralı bloklar, ağa göre bir diziye, karusele veya metin gövdesine dönüşür.

Referansla medya

Medya kütüphanesine bir kez yükleyin ve kimliğiyle istediğiniz sayıda gönderiye ekleyin.

Idempotent

Bir idempotency anahtarı gönderin; yeniden denenen istek asla çift gönderi oluşturmaz.

Takip et

Her gönderinin tam olarak nereye ulaştığını bilin

Bir gönderi, hesap başına bir teslimata ayrılır. Teslimatlar uç noktasını sorgulayın veya bir webhook'a abone olun; platform durumunu, harici kimliği, kalıcı bağlantıyı ve bir ağ bir şeyi reddettiğinde hata metnini alırsınız.

Webhook Olaylarını Görün

Tek bir çalışma alanında tüm ağlardaki bağlı hesaplar

Teslimatlar uç noktası

GET /v1/posts/:id/deliveries, her hesabı kendi durumuyla listeler.

Webhook olayları

delivery.published ve delivery.failed, teslimat sonuçlandığı anda tetiklenir.

Yerleşik yeniden deneme

Geçici platform hataları, başarısız olarak görünmeden önce artan aralıklarla yeniden denenir.

Yönet

Koddan düzenleyin, iptal edin ve silin

Tüm yaşam döngüsü API'de. Planlanmış bir gönderiyi yayınlanmadan önce güncelleyin, iptal edin veya yayınlanmış bir gönderiyi ulaştığı ağdan silin. Birden fazla marka yönettiğinizde etiketler ve çalışma alanları müşteri işlerini birbirinden ayrı tutar.

Geliştirmeye Başlayın

PUT /v1/posts/:id

curl -X PUT https://api.fopost.com/v1/posts/7d3e0a52-... \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "content": [{ "text": "Updated copy." }] }'

Yayından önce düzenleyin

Kuyrukta bekleyen her şeyin metnini, medyasını veya hesaplarını değiştirin.

Etiketler

Gönderileri kampanya veya müşteriye göre etiketleyin ve her liste uç noktasını etikete göre filtreleyin.

Çalışma Alanları

Anahtarlar çalışma alanı başınadır, bu yüzden bir müşteri asla diğerine erişemez.

Paylaşım API'si hakkında sorular ve yanıtlar

Kimlik doğrulamayı nasıl yaparım?

Panelde Ayarlar bölümünden bir API anahtarı oluşturun, ardından bunu X-API-Key başlığında gönderin. Her anahtar tek bir çalışma alanına aittir ve yalnızca verdiğiniz kapsamları taşır.

Hangi ağlarda paylaşım yapabilirim?

Çalışma alanına bağlı her hesapta, FoPost'un desteklediği tüm ağlarda. İstek yapısı hepsi için aynıdır.

Görsel ve video ekleyebilir miyim?

Evet. Media API üzerinden bir kez yükleyin, ardından gönderide medya kimliğine başvurun. Ağa özel boyut ve biçim sınırları sizin yerinize uygulanır.

Bir ağ çalışmıyorsa ne olur?

Teslimat artan aralıklarla yeniden denenir. Yine başarısız olursa teslimat, platform hatasıyla birlikte başarısız olarak işaretlenir ve bir delivery.failed webhook'u tetiklenir.

İstek sınırı var mı?

Evet, anahtar başına dakikada 100 istek. Sınır ve kalan sayı yanıt başlıklarında döner.

SDK var mı?

Tip güvenli bir TypeScript SDK'sı, AI istemcileri için bir MCP sunucusu ve ücretsiz PHP, Laravel ve WordPress paketleri. Diğer diller için OpenAPI şartnamesi API'den sunulur.

Paylaşım API'si 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