Planlama API'siAPI

Tek alanla gönderi planlayın

Hemen yayınlayacağınız gövdenin aynısını gönderin, bir schedule_at zaman damgası ekleyin; FoPost gönderiyi o zamana kadar kuyrukta tutar. Yayınlandığı ana kadar her şey düzenlenebilir kalır ve teslimat hesap başına bildirilir.

API Anahtarını AlBelgeleri 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-...",
    "status": "scheduled",
    "schedule_at": "2026-09-01T09:00:00Z",
    "content": [{ "text": "Webhook retries are live. Read the changelog." }],
    "accounts": ["4a71d80b-...", "c30e9f12-..."]
  }'

Tek zaman damgası

Gelecekteki herhangi bir ISO 8601 zamanı. Kuyruk onu alır ve zamanında yayınlar.

Gönderilene kadar düzenlenebilir

Kuyrukta bekleyen her şeyin metnini, medyasını, hesaplarını veya zamanını PUT ile güncelleyin.

Hesap başına teslimat

Yayınlandığında her hesap kendi durumunu ve kalıcı bağlantısını bildirir.

Kuyruk

Bir haftalık gönderiyi tek betikle planlayın

İçeriğiniz üzerinde döngü kurun, her öğe için bir zaman seçin ve gönderileri oluşturun. Kuyruk FoPost'ta çalışır, bu yüzden kendi işleminiz istek döner dönmez kapanabilir. Sırada ne olduğunu görmek için planlanmış gönderileri istediğiniz zaman listeleyin.

Gönderi Referansını Okuyun
GET /v1/posts?status=scheduled
curl "https://api.fopost.com/v1/posts?workspace_id=9b2f6c1e-...&status=scheduled" \
  -H "X-API-Key: $API_KEY"

{
  "data": [
    { "id": "7d3e0a52-...", "status": "scheduled", "schedule_at": "2026-09-01T09:00:00Z", "accounts": [{ "id": "4a71d80b-...", "platform": "linkedin", "publish_status": "pending" }] },
    { "id": "8e4f1b63-...", "status": "scheduled", "schedule_at": "2026-09-02T09:00:00Z", "accounts": [{ "id": "c30e9f12-...", "platform": "twitter", "publish_status": "pending" }] }
  ],
  "meta": { "page": 1, "per_page": 30, "total": 2, "total_pages": 1 }
}

Duruma göre filtreleyin

Taslak, planlanmış, yayınlanmış veya başarısız gönderileri tek bir sorgu parametresiyle listeleyin.

Etiketler

Her gönderiyi kampanyaya göre etiketleyin ve kuyruğu etikete göre filtreleyin.

Çalışma alanı başına

Bir anahtar tek bir çalışma alanını görür, bu yüzden bir müşterinin kuyruğu asla diğerininkiyle karışmaz.

Ayarla

Yayınlanmadan önce taşıyın, yeniden yazın veya iptal edin

Planlar değişir. Planlanmış bir gönderinin zamanını, metnini, medyasını veya hedef hesaplarını değiştirmek için PUT kullanın. İptal ederseniz iptal edildi olarak işaretlenir ve asla teslim edilmez; isterseniz tamamen silin. Kuyruk onu alana kadar hiçbir şey kilitlenmez.

PUT Uç Noktasını Görü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 '{ "schedule_at": "2026-09-01T14:00:00Z" }'

Yeniden planla

schedule_at değerini değiştirin, kuyruk gönderiyi yeni zamana taşısın.

İçeriği değiştirin

Kuyruktaki bir gönderinin içerik dizisini veya medya kimliklerini değiştirin.

İptal edin veya silin

Kuyruktaki başka hiçbir şeye dokunmadan bir gönderiyi kuyruktan çıkarın.

Onayla

Sorgulamadan, ne zaman yayınlandığını bilin

Planlanan zaman geldiğinde gönderi, hesap başına bir teslimata ayrılır. Bir webhook kaydedin; her biri için delivery.published veya delivery.failed tetiklenir. Çekme modelini tercih ederseniz teslimatlar uç noktasını sorgulayın.

Geliştirmeye Başlayın
Yayın takviminde bir aylık planlanmış gönderiler

Sonuçlanınca webhook

delivery.published; gönderi kimliğini, hesabı ve kalıcı bağlantıyı taşır.

Yeniden denemeler

Geçici ağ hataları, bir başarısızlık bildirilmeden önce artan aralıklarla yeniden denenir.

Ardından analitik

Yayına girdikten sonra aynı gönderi kimliği, Analytics API'den gösterim ve etkileşim verilerini okur.

Planlama API'si hakkında sorular ve yanıtlar

Ne kadar ileriye planlayabilirim?

İstediğiniz kadar. Gelecekteki her ISO 8601 zaman damgası kabul edilir ve kuyruk gönderiyi o zamana kadar tutar.

schedule_at hangi saat dilimini kullanır?

Z ile biten, UTC biçiminde bir ISO 8601 zaman damgası gönderin. Gönderdiğiniz değer çalışan değerdir; sunucuda dönüştürme yapılmaz.

Planladıktan sonra bir gönderiyi düzenleyebilir miyim?

Evet. Henüz yayınlanmamış bir gönderide zaman dahil her alanı PUT ile güncelleyin. Yayınlandıktan sonra düzenlemeler kayda uygulanır; bir ağdan kaldırmak için silme işlemini kullanırsınız.

Yayın anında sunucum çalışmıyorsa ne olur?

Hiçbir şey değişmez. Kuyruk sizin altyapınızda değil FoPost'un içinde çalışır, bu yüzden gönderi işleminiz çalışsa da çalışmasa da yayınlanır.

Hesapların yalnızca bir kısmına planlayabilir miyim?

Evet. accounts dizisi hedef listesidir. Yalnızca gönderiyi alması gereken hesapları ekleyin; her biri kendi teslimat kaydını alır.

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

Evet, anahtar başına dakikada 100 istek. Bir haftalık gönderiyi tek betikle planlamak bu sınıra rahatça sığar.

Planlama 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