Postingan dan penjadwalan

Dapatkan kunci API

Postingan milik sebuah usaha dan dikirim ke satu atau beberapa jaringan, yaitu target-nya. Setiap target punya teks, media, format, dan status sendiri.

Endpoint

POST/v1/postsGET/v1/postsGET/v1/posts/{id}PATCH/v1/posts/{id}DELETE/v1/posts/{id}

Body sebuah postingan

Field	Arti
`establishmentId`	Usaha yang memublikasikan (`GET /v1/establishments`)
`targets[]`	Satu entri per jaringan: `platform`, `text`, `media` opsional, `format`, dan `accountId`
`targets[].media[]`	Media dari pustaka lewat `id`, atau `url` https publik beserta `type`-nya (`image` atau `video`)
`targets[].accountId`	Akun yang dipakai bila usaha punya beberapa akun di jaringan itu
`scheduledAt`	Tanggal-waktu ISO 8601 di masa depan; bila tidak ada, postingan terkirim sekarang
`status`	`draft` untuk menyimpan draf yang tidak terkirim (tanpa `scheduledAt`)

Status

Status	Arti
`draft`	Tersimpan, tidak terkirim
`scheduled`	Akan terkirim pada `scheduledAt`
`publishing`	Sedang dikirim ke jaringan
`published`	Sudah tayang, dengan `permalink`-nya
`failed`	Ditolak jaringan; `error` menjelaskan alasannya
`sent_to_inbox`	Dikirim ke aplikasi jaringan, tempat pemilik menyelesaikannya (TikTok)

status postingan merangkum targetnya. Nilainya partial bila satu jaringan terbit dan yang lain gagal.

Edit sebelum terkirim

PATCH /v1/posts/{id} menulis ulang target, memindahkan scheduledAt, atau mengubah status: draft menghapus waktu dan menyimpan konten, scheduled menjadwalkannya kembali. Setelah jaringan mengirim postingan, jawabannya 409 post_not_editable.

bash

curl -X PATCH https://api.sofia-post.com/api/v1/posts/$POST_ID \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"status":"scheduled","scheduledAt":"2026-11-20T09:00:00Z"}'

Hapus

DELETE /v1/posts/{id} dijawab 204. Selagi jaringan mengirim postingan, jawabannya 409 post_in_flight: coba lagi sebentar lagi.

Menampilkan postingan

GET /v1/posts menampilkan setiap postingan yang dapat dijangkau token, terbaru lebih dulu, dengan filter establishmentId, status, from, to, dan createdBy (me atau app). Postingan cocok dengan status bila setidaknya satu jaringannya berada pada status itu. Lihat paginasi.