Postingan

Ambil postingan

Mengembalikan postingan dengan status tiap jaringan, tautan, dan kesalahan bila gagal. Live membaca postingan apa pun di Workspace, uji yang disimulasikan.

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

Ambil postingan

curl -X GET 'https://api.sofia-post.com/api/v1/posts/{id}' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

{
  "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"
    }
  ]
}

Ambil postingan

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/posts/<id>' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "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"
    }
  ]
}

Baca postingan untuk memantau status setiap jaringannya: setiap target berubah menjadi published dengan tautan permanennya, atau failed dengan alasannya. Untuk diberi tahu tanpa menanyai API, daftarkan webhook.

{
  "id": "efc578cc-ef79-40e9-876d-be1a33d3b8db",
  "status": "published",
  "targets": [
    {
      "platform": "instagram",
      "state": "published",
      "publishedAt": "2026-11-02T20:17:25.453Z",
      "permalink": "https://www.instagram.com/p/DfQJVPGFfb_/"
    }
  ]
}

Status

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

status postingan merangkum targetnya. Bernilai partial jika satu jaringan sudah menerbitkan dan yang lain gagal.

Otorisasi

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

Parameter path

idstringwajib
Pengenal postingan.

Respons

Postingan dan status tiap target.

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?