ドライランとテストモード

API キーを取得

POST /v1/posts?dry_run=true は、実際の公開と同じチェックを実行します。対象は、各ネットワークのルール、連携済みアカウント、メディア、日時、ご利用のプランです。何も保存せず、何も送信しません。

準備完了

すべてのネットワークが投稿を受け付ける場合、応答は 200 で status: "ready" となり、各ターゲットについて、投稿に使われるアカウントが含まれます。

拒否

そうでない場合、応答は 422 post_refused で、理由ごとに 1 件の詳細が付きます。各詳細には、ネットワーク、code、修正すべき点が示されます。

json
{
  "error": {
    "code": "post_refused",
    "message": "The post would not be published: x: the text is too long (300 characters, at most 280)",
    "details": [
      {
        "platform": "x",
        "code": "caption_too_long",
        "max": 280,
        "actual": 300,
        "message": "x: the text is too long (300 characters, at most 280)"
      }
    ],
    "docUrl": "https://www.sofia-post.com/developers/errors#post_refused"
  }
}

すべての理由はエラーに一覧があります。

テストモード

test モードで作成したアプリケーション(sofia_test_at_… トークン)は、実際の Workspace を読み取れますが、書き込みは行いません。投稿はシミュレートされ、同じルールで判定され、実際の書き込みは 403 live_mode_required で応答されます。設定 › API で作成したキーとクライアントは live です。公開せずに確認するには、ドライランを使ってください。