制限とエラー

このページには、API 全体で共有されるルールがまとめられています。必須フィールド、ライフサイクル動作、およびモデル固有のセマンティクスは、引き続き各 API ページに属します。

共有制限

アイテム	制限
リクエストボディサイズ	最大32KB。
ゲートウェイで生成された ID	32 個の小文字の 16 進文字。
Channel パスワード	通常は 8 ～ 128 文字です。
`op_id`	1 ～ 128 文字。文字、数字、`_`、`:`、`-`。
`images`	最大 32 の URL、それぞれ最大 2048 文字。
`tags`	最大 32 個のタグ、それぞれ最大 64 文字、トリミングおよび重複排除。
`metadata`	スカラー値のみ。キーは最大 64、値は最大 512。
`attrs`	オブジェクトパッチ; `null` はキーを削除します。複雑な入れ子は避けてください。
`ttl`	Unix ミリ秒のタイムスタンプ。プロバイダーの配信 TTL は約 28 日に制限されています。
不明なフィールド	ネイティブ Message、Event、Thing、および MCP ツールの引数は厳密です。不明なフィールドは 400 を返します。

成功:

{
  "success": true,
  "data": {
    "accepted": true
  },
  "error": null,
  "error_code": null
}

失敗:

{
  "success": false,
  "data": null,
  "error": "human readable message",
  "error_code": "machine_readable_code"
}

オートメーションでは、自然言語の error テキストよりも success および error_code を優先する必要があります。

success=true は、Gateway がリクエストを処理したことを意味します。 accepted=true はディスパッチに入ったことを意味します。

以下のことを保証するものではありません。

accepted を、エンドデバイスの表示受信としてではなく、Gateway の受け入れおよび発送ステータスとして扱います。

ステータス	意味	典型的な理由	何をすべきか
`200`	Gateway がリクエストを処理しました	`success=true` ですが、それでも `accepted` を確認してください	返された ID と `op_id` を保存します。
`400`	検証に失敗しました	必須フィールドが欠落している、不明なフィールド、不正な形式	JSON を API フィールドテーブルと比較します。
`401`	Gateway 認証に失敗しました	プライベート Gateway は `PUSHGO_TOKEN` を使用します。 Bearer トークンが見つからないか間違っています	`Authorization: Bearer <token>`を確認してください。
`404`	ターゲットが見つかりません	Channel、Event、または Thing が存在しません	`channel_id`、`event_id`、`thing_id`を確認してください。
`413`	リクエスト本文が大きすぎます	JSON が 32KB を超えています	画像 URL を使用します。メタデータまたは属性を削減します。
`503`	派遣は完全には受け付けられていません	プロバイダー、プライベートトランスポート、キュー、またはダウンストリームが利用不可	Gateway のログ、統計、キュー容量を検査します。