Gönderiler ve Planlama
Taslak, zamanlanmış ve publish_now modlarıyla gönderi yaşam döngüsü.
Gönderiler
Gönderi modları
POST /posts endpointinde mode alanı kaydın nasıl işleneceğini belirler.
draft
Panelde düzenlenebilir taslak olarak kalır.
scheduled
scheduledAt ile planlı yayın kuyruğuna girer.
publish_now
Sadece posts:publish scope'u varsa anında yayınlanır.
Planlama zamanı
scheduledAt ISO 8601 formatında UTC zaman damgası bekler. Geçmiş tarih 422 validation_error döner.
Gönderi planla
curl -X POST https://api.xplanner.co/v1/posts \ -H "Authorization: Bearer $XPLANNER_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: post-scheduled-001" \ -d '{ "accountId": "acc_123", "mode": "scheduled", "scheduledAt": "2026-05-20T09:00:00.000Z", "text": "Haftalık ürün güncellemesi hazır." }'Medya kuralları
X limitlerine uyum için post başına en fazla 4 görsel veya tek GIF desteklenir.
Alt text maksimum 1000 karakterdir.
Idea içinde 10 görsel veya 4 GIF saklanabilir.
Gönderi publish akışında birden çok GIF desteklenmez.
Detay, güncelleme ve riskli aksiyonlar
Yeni detay endpointleriyle mevcut gönderiyi okuyabilir, PATCH ile güncelleyebilir, cancel ile planını iptal edebilir veya publish ile yayın kuyruğuna alabilirsin.
GET /posts/{id} posts:read ile tekil gönderi döndürür.
PATCH /posts/{id} posts:update veya eski posts:write ile çalışır.
POST /posts/{id}/cancel posts:schedule veya eski posts:write ile çalışır.
POST /posts/{id}/publish yalnızca posts:publish kabul eder.