投稿

投稿を編集する

送信前なら targets の置換、scheduledAt の設定、draft と scheduled の切り替えができます。

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

投稿を編集する

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

投稿を編集する

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} は、ターゲットの書き換え、scheduledAt の移動、status の変更ができます。draft にすると予約が外れて内容は残り、scheduled にすると再予約されます。ネットワークが投稿を送信した後は、レスポンスが 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"}'

認可

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

パスパラメーター

idstring必須
投稿の ID。

ボディ

application/json

targetsobject[]
すべてのターゲットを書き換えます（テキスト、メディア、フォーマット、アカウント）。省略すると維持されます
子属性を表示
- platformstring必須
  対象のネットワーク
  使用できる値： instagramfacebookxlinkedintiktok
- textstring必須
  このネットワークで公開するキャプション
- mediaobject[]
  添付するメディア
  子属性を表示
  - idstring
    店舗のライブラリにあるメディアの ID（なければ url と type）
  - urlstring
    メディアの公開 URL（ライブでは https）。ID がない場合
  - typestring
    URL で指定したメディアの種類
    使用できる値： imagevideo
- formatstring
  フォーマット（post、reel、story、carousel など）。省略時はネットワークが提供するもの
- accountIdstring
  ライブ：店舗がこのネットワークに複数のアカウントを持つ場合に、公開する連携アカウント（GET /v1/establishments/:id/accounts）
scheduledAtstring<date-time>
新しい日時（未来）：この日時に投稿が予約されます
statusstring
draft：下書きに戻す（内容は維持、日時は失われる）。scheduled：scheduledAt に、または元の日時で予約
使用できる値： draftscheduled

レスポンス

編集後の投稿。

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>
投稿の公開予定日時

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