Postingan

Ubah postingan

Sebelum jaringan mengirim, mengganti targets, mengatur scheduledAt, atau memindahkan postingan antara draft dan scheduled. Kolom yang dihilangkan tetap.

PATCHhttps://api.sofia-post.com/api/v1/posts/{id}

PATCH/v1/posts/{id}

Kunci API atau access tokenHanya disimpan di tab ini, dan hanya dikirim ke api.sofia-post.com.id (path)Body permintaan

Permintaan ini bertindak pada akun asli Anda.

curl -X PATCH 'https://api.sofia-post.com/api/v1/posts/{id}' \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"scheduledAt":"2026-11-02T10:00:00.000Z"}'

Otorisasi

Authorizationstringwajib
Kunci pribadi atau access token OAuth Anda, dikirim sebagai Bearer <token>.

Parameter path

idstringwajib
Pengenal postingan.

Body

application/json

targetsobject[]
Semua target, ditulis ulang (teks, media, format, akun); tidak diisi: tetap
Tampilkan atribut turunan
- platformstringwajib
  Jaringan yang dituju
  Nilai yang diizinkan: instagramfacebookxlinkedintiktok
- textstringwajib
  Caption yang dipublikasikan di jaringan ini
- mediaobject[]
  Media terlampir
  Tampilkan atribut turunan
  - idstring
    Pengenal media di pustaka usaha (jika tidak, url dan type)
  - urlstring
    Alamat publik media (https di live); tanpa pengenal
  - typestring
    Jenis media yang diberikan lewat alamat
    Nilai yang diizinkan: imagevideo
- formatstring
  Format (post, reel, story, carousel...); default-nya yang akan disajikan jaringan
- accountIdstring
  Live: akun terhubung yang memublikasikan, bila usaha memiliki beberapa di jaringan ini (GET /v1/establishments/:id/accounts)
scheduledAtstring<date-time>
Tanggal baru, di masa depan: postingan dijadwalkan pada tanggal ini
statusstring
draft: kembali ke draf (isi tetap, waktu hilang); scheduled: jadwalkan pada scheduledAt, atau pada waktu yang dimilikinya
Nilai yang diizinkan: draftscheduled

Respons

200application/json

Postingan setelah diubah.

idstringwajib
Pengenal postingan
statusstringwajib
Di semua jaringan; partial: terbit di satu, gagal di yang lain
Nilai yang diizinkan: draftscheduledpublishingpublishedsent_to_inboxfailedpartial
establishmentIdstringwajib
Usaha pemilik postingan
createdAtstring<date-time>wajib
Kapan postingan dibuat
targetsobject[]wajib
Satu entri per jaringan dan akun: dua akun di satu jaringan, dua entri
Tampilkan atribut turunan
- platformstringwajib
  Jaringan target
- accountIdstringwajib
  Akun yang memublikasikan (GET /v1/establishments/:id/accounts)
- statestringwajib
  Status target di jaringannya
  Nilai yang diizinkan: draftscheduledpublishingpublishedsent_to_inboxfailed
- publishedAtstring<date-time>
  Kapan target dipublikasikan
- permalinkstring
  Tautan ke postingan yang terbit di jaringan
- errorstring
  Alasan jaringan menolak
scheduledAtstring<date-time>
Kapan postingan dijadwalkan untuk dipublikasikan

402

subscription_required.

403

live_mode_required untuk aplikasi uji, atau scope posts:write tidak ada.

404

post_not_found: di luar jangkauan token.

409

post_not_editable: sebuah jaringan sudah atau sedang mengirim.

422application/json

post_refused: sebuah jaringan, usaha, atau Publishing akan menolak postingan yang diubah. duplicate_platform untuk dua target pada satu jaringan.

4XXapplication/json

Kesalahan lain apa pun, dalam amplop kesalahan.