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}

Ubah postingan

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"}'

{
  "id": "string",
  "status": "published",
  "establishmentId": "string",
  "scheduledAt": "2026-11-02T10:00:00.000Z",
  "createdAt": "2026-11-02T10:00:00.000Z",
  "targets": [
    {
      "platform": "instagram",
      "accountId": "string",
      "state": "published",
      "permalink": "https://www.instagram.com/p/C1"
    }
  ]
}

Ubah postingan

curl --request PATCH \
  --url 'https://api.sofia-post.com/api/v1/posts/<id>' \
  --header "Authorization: Bearer $SOFIA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "scheduledAt": "2026-11-02T10:00:00.000Z"
}'

{
  "id": "string",
  "status": "published",
  "establishmentId": "string",
  "scheduledAt": "2026-11-02T10:00:00.000Z",
  "createdAt": "2026-11-02T10:00:00.000Z",
  "targets": [
    {
      "platform": "instagram",
      "accountId": "string",
      "state": "published",
      "permalink": "https://www.instagram.com/p/C1"
    }
  ]
}

PATCH /v1/posts/{id} menulis ulang target, memindahkan scheduledAt, atau mengubah status: draft menghapus jadwal dan mempertahankan konten, scheduled menjadwalkannya ulang. Setelah sebuah jaringan mengirim postingan, responsnya 409 post_not_editable.

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"}'

Otorisasi

Authorizationstringheaderwajib
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

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

Apakah halaman ini membantu?