投稿

投稿を取得する

各ネットワークの状態、公開後のリンク、失敗時のエラーを含む投稿を返します。ライブは Workspace の任意の投稿、テストはシミュレーション分を読み取ります。

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

投稿を取得する

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

投稿を取得する

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

投稿を読み取ると、各ネットワークの状態を追跡できます。各ターゲットは、パーマリンクつきの published か、理由つきの failed になります。API を呼び出さずに通知を受けるには、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_/"
    }
  ]
}

状態

状態	意味
`draft`	保存済みで、公開されない
`scheduled`	`scheduledAt` に公開される
`publishing`	ネットワークへ送信中
`published`	公開済みで、`permalink` がある
`failed`	ネットワークに拒否された。理由は `error` に示される
`sent_to_inbox`	ネットワークのアプリに送信済みで、オーナーがそこで仕上げる（TikTok）

投稿の status は、そのターゲットを要約したものです。あるネットワークが公開され、別のネットワークが失敗した場合は partial になります。

認可

Authorizationstringheader必須
個人キーまたは OAuth アクセストークン。Bearer <token> として送信します。

パスパラメーター

idstring必須
投稿の ID。

レスポンス

投稿と各ターゲットの状態。

idstring必須
投稿の ID
statusstring必須
全ネットワークを通じた状態。partial：一方で公開され、別の一方で失敗
使用できる値： draftscheduledpublishingpublishedsent_to_inboxfailedpartial
establishmentIdstring必須
投稿の店舗
createdAtstring<date-time>必須
投稿が作成された日時
targetsobject[]必須
ネットワークとアカウントごとに 1 件。1 つのネットワークに 2 アカウントなら 2 件
子属性を表示
- platformstring必須
  ターゲットのネットワーク
- accountIdstring必須
  公開するアカウント（GET /v1/establishments/:id/accounts）
- statestring必須
  ネットワーク上でのターゲットの状態
  使用できる値： draftscheduledpublishingpublishedsent_to_inboxfailed
- publishedAtstring<date-time>
  ターゲットが公開された日時
- permalinkstring
  ネットワーク上の公開済み投稿へのリンク
- errorstring
  ネットワークが拒否した理由
scheduledAtstring<date-time>
投稿の公開予定日時

このページは役に立ちましたか？