Gönderi oluştur / planla / yayınla


POST https://app.apsilo.com/api/public/v1/social/posts

Tek gönderiyi birden fazla platforma hedefler. publish=now|schedule iken platform kuralları kayıttan önce denetlenir (422 SOCIAL_POST_INVALID, details sorun listesi); yayına alınamazsa taslak kalmaz. Firma onay akışı açıksa gönderi pending_approval olur. Yayın ücreti platform gönderi fiyatından düşer.

Gerekli kapsam: social:write

Parametreler

Parametre	Yer	Tip	Gereklilik	Açıklama
`Idempotency-Key`	başlık	string	isteğe bağlı	İsteğe özgü benzersiz değer (1–255 yazdırılabilir ASCII; ör. UUID). Aynı anahtar + aynı yol ve gövde 24 saat içinde kaydedilmiş yanıtı döner (`Idempotent-Replayed: true`); farklı gövde veya işlenmekte olan istek `409 IDEMPOTENCY_CONFLICT`. Hata yanıtları saklanmaz.
`X-Request-Id`	başlık	string	isteğe bağlı	İsteğe bağlı istek kimliğiniz (8–100 karakter: harf, rakam, `._:-`); yanıtta aynen döner ve kayıtlara işlenir.

İstek gövdesi

Alan	Tip	Gereklilik	Açıklama
`title`	string \| null	isteğe bağlı	İç kullanım adı (takvimde görünür)
`caption`	string	isteğe bağlı	Ortak metin Varsayılan: `""`.
`mediaIds`	string (uuid)[]	isteğe bağlı	Ortak medya (sıralı, `POST /media`) Varsayılan: `[]`.
`targets`	object[]	zorunlu	Platform hedefleri (platform başına biçim, isteğe bağlı özel metin/medya, X flood, ilk yorum, seçenekler)
`scheduledAt`	string (date-time) \| null	isteğe bağlı	`publish=schedule` için yayın zamanı
`notes`	string \| null	isteğe bağlı
`publish`	`draft` · `now` · `schedule`	isteğe bağlı	`draft` yalnızca kaydeder; `now` hemen yayınlar; `schedule` `scheduledAt` zamanında yayınlar. Firma onay akışı açıksa `now`/`schedule` onaya gönderir (`pending_approval`). Varsayılan: `"draft"`.


{
  "title": "Ekim kampanyası duyurusu",
  "caption": "Ekim boyunca tüm filtre kahvelerde %20 indirim! ☕ #demokahve #ekim",
  "mediaIds": [
    "0b9e4c1a-6f2d-4a7b-9c3e-000000000042"
  ],
  "targets": [
    {
      "platform": "instagram",
      "format": "feed",
      "options": {
        "altTexts": {
          "0b9e4c1a-6f2d-4a7b-9c3e-000000000042": "Kahve fincanı ve çekirdekler"
        }
      }
    },
    {
      "platform": "x",
      "format": "post",
      "caption": "Ekim boyunca filtre kahvelerde %20 indirim ☕ demokahve.com/ekim"
    }
  ],
  "publish": "schedule",
  "scheduledAt": "2026-10-01T09:00:00+03:00"
}

Yanıtlar

Durum	Açıklama
`201`	Gönderi oluşturuldu
`401`	Kimlik doğrulanamadı. Olası kodlar: `API_KEY_INVALID`, `API_KEY_REVOKED`, `API_KEY_EXPIRED`.
`402`	Bakiye yetersiz. Olası kodlar: `INSUFFICIENT_BALANCE`.
`403`	Erişim reddedildi. Olası kodlar: `FEATURE_NOT_LICENSED`, `API_SCOPE_MISSING`, `IP_NOT_ALLOWED`, `LICENSE_EXPIRED`, `LICENSE_NOT_FOUND`, `FORBIDDEN`.
`409`	Çakışma. Olası kodlar: `CONFLICT`, `IDEMPOTENCY_CONFLICT`, `MEDIA_IN_USE`, `SOCIAL_APPROVAL_REQUIRED`, `SOCIAL_POST_NOT_EDITABLE`.
`422`	İşlenemeyen istek. Olası kodlar: `VALIDATION_FAILED`, `MESSAGING_WINDOW_CLOSED`, `CHANNEL_ACCOUNT_MISSING`, `CONTACT_BLOCKED`, `STORAGE_LIMIT_REACHED`, `SOCIAL_POST_INVALID`, `SOCIAL_PLATFORM_UNAVAILABLE`.
`429`	Hız sınırı aşıldı. Olası kodlar: `RATE_LIMITED`.
`500`	Sunucu hatası. Olası kodlar: `INTERNAL`.

Yanıt gövdesi

Alan	Tip	Gereklilik	Açıklama
`data`	SocialPost	zorunlu