メインコンテンツまでスキップ

GET /v1/inflow_routes

scope​

write_inflow_routes

リクエストパラメーター​

名前位置型必須説明
limitクエリinteger任意1 回に返す件数（1〜100）。既定 20
offsetクエリinteger任意取得を開始する位置（0 始まり）。⚠️ 走査の途中でデータが更新されると取りこぼす。注文の増分取得には after_id と updated_since を使ってください

レスポンスの例​

{
  "data": [
    {
      "id": "42",
      "code": "a7Kq2mZ0xB",
      "name": "夏キャンペーン",
      "link": "string",
      "redirect_url": "string",
      "valid_from": "2026-09-01",
      "valid_to": "2026-12-31",
      "created_at": "2026-06-01T03:00:00Z"
    }
  ],
  "pagination": {
    "limit": 0,
    "offset": 0,
    "total": 0
  }
}

解説​

自ショップの流入経路リンクを一覧取得します。発行済みの code を回収する用途を想定しており、write_inflow_routes スコープが必要です。

エラーレスポンスの例​

{
  "error": {
    "code": "insufficient_scope",
    "message": "requires scope 'write_inflow_routes'",
    "request_id": "req_01H..."
  }
}

返しうるエラー: 401 / 403