Postingan

Daftar postingan

Mendaftar postingan usaha yang dijangkau token, terbaru lebih dulu, dapat difilter menurut usaha, status, rentang tanggal, dan penulis, per halaman.

GEThttps://api.sofia-post.com/api/v1/posts

Daftar postingan

Mendaftar postingan usaha yang dijangkau token, terbaru lebih dulu, dapat difilter menurut usaha, status, rentang tanggal, dan penulis, per halaman.

Otorisasi

Authorizationstringwajib

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

Hanya disimpan di tab ini, dan hanya dikirim ke api.sofia-post.com. Dapatkan kunci API

Parameter query

establishmentIdstring

Hanya postingan usaha ini.

cursorstring

nextCursor dari halaman sebelumnya.

statusstring

Live: minimal satu jaringan dalam status ini. status postingan meringkas jaringannya, jadi memfilter failed bisa mengembalikan partial.

fromstring<date-time>

Live: minimal satu jaringan terpublikasi (atau, sebelum publikasi, terjadwal) sejak saat ini.

tostring<date-time>

Live: dan sebelum saat ini (tidak termasuk).

createdBystring

Live: me untuk postingan orang yang diwakili token, app untuk yang dibuat aplikasi ini. Tidak diisi: semuanya.

limitnumber

Ukuran halaman, dari 1 sampai 100 (default 20).

Daftar postingan

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

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

Daftar postingan

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

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

GET /v1/posts mendaftar semua postingan yang dapat diakses token, yang terbaru lebih dulu, disaring menurut establishmentId, status, from, to, dan createdBy (me atau app). Sebuah postingan cocok dengan status jika setidaknya satu jaringannya berada dalam keadaan itu. Lihat paginasi.

Status yang mungkin dari sebuah postingan dijelaskan di halaman Membaca postingan.

Otorisasi

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

Parameter query

establishmentIdstring
Hanya postingan usaha ini.
cursorstring
nextCursor dari halaman sebelumnya.
statusstring
Live: minimal satu jaringan dalam status ini. status postingan meringkas jaringannya, jadi memfilter failed bisa mengembalikan partial.
Nilai yang diizinkan: draftscheduledpublishingpublishedsent_to_inboxfailed
fromstring<date-time>
Live: minimal satu jaringan terpublikasi (atau, sebelum publikasi, terjadwal) sejak saat ini.
tostring<date-time>
Live: dan sebelum saat ini (tidak termasuk).
createdBystring
Live: me untuk postingan orang yang diwakili token, app untuk yang dibuat aplikasi ini. Tidak diisi: semuanya.
Nilai yang diizinkan: meapp
limitnumber
Ukuran halaman, dari 1 sampai 100 (default 20).

Respons

Satu halaman postingan, dengan nextCursor bila masih ada lanjutan.

dataobject[]wajib
Postingan di halaman ini
Tampilkan atribut turunan
- 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
nextCursorstring
Teruskan sebagai ?cursor= untuk halaman berikutnya; tidak ada di akhir

Apakah halaman ini membantu?