公開されている企画の一覧をページネーション付きで取得します。新しい企画が先頭に表示されます。

Query Parameters

Request

curl https://tanebi.app/api/v1/ideas?page=1&per_page=10 \
  -H "X-API-Key: your_api_key_here"

Response 200

{
  "ideas": [
    {
      "id": 42,
      "title": "AIを活用した料理レシピ提案アプリ",
      "visibility": "public",
      "current_stage": "hidane",
      "reactions_count": 5,
      "comments_count": 3,
      "is_bookmarked": false,
      "created_at": "2026-02-10T12:00:00.000Z",
      "updated_at": "2026-02-11T08:30:00.000Z",
      "user": {
        "id": 7,
        "display_name": "Yuki",
        "avatar_path": "avatars/7/profile.jpg"
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 3,
    "total_count": 42
  }
}

指定した企画の詳細情報を取得します。本文のライン情報とリアクションを含みます。

Path Parameters

Request

curl https://tanebi.app/api/v1/ideas/42 \
  -H "X-API-Key: your_api_key_here"

Response 200

{
  "id": 42,
  "title": "AIを活用した料理レシピ提案アプリ",
  "visibility": "public",
  "current_stage": "honoo",
  "reactions_count": 5,
  "is_bookmarked": false,
  "created_at": "2026-02-10T12:00:00.000Z",
  "updated_at": "2026-02-11T08:30:00.000Z",
  "user": {
    "id": 7,
    "display_name": "Yuki",
    "avatar_path": "avatars/7/profile.jpg"
  },
  "lines": [
    {
      "id": 101,
      "line_type": "heading",
      "content": "# 概要",
      "position": 0,
      "comments_count": 0
    },
    {
      "id": 102,
      "line_type": "text",
      "content": "冷蔵庫の中身を撮影するだけで、AIが最適なレシピを提案するアプリ。",
      "position": 1,
      "comments_count": 2
    }
  ],
  "reactions": [
    {
      "id": 201,
      "reaction_type": "fire",
      "created_at": "2026-02-10T15:00:00.000Z",
      "user": {
        "id": 12,
        "display_name": "Taro",
        "avatar_path": null
      }
    }
  ]
}

Error Responses

• 404指定した企画が存在しない、または削除済み
• 403非公開の企画でアクセス権がない

新しい企画を作成します。content は空行（\n\n）で段落に分割され、# で始まる段落は見出し（heading）として扱われます。 ステージは自動的に hidane で開始されます。

Request Body (JSON)

Request

curl -X POST https://tanebi.app/api/v1/ideas \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "ペット向けヘルスケアIoTデバイス",
    "content": "# 概要\n\nペットの健康状態をリアルタイムで監視するウェアラブルデバイス。\n\n# ターゲット\n\n犬・猫を飼っている30-40代の共働き世帯。",
    "visibility": "public"
  }'

Response 201

{
  "id": 43,
  "title": "ペット向けヘルスケアIoTデバイス",
  "visibility": "public",
  "current_stage": "hidane",
  "reactions_count": 0,
  "is_bookmarked": false,
  "user": { ... },
  "lines": [
    { "id": 201, "line_type": "heading", "content": "# 概要", "position": 0 },
    { "id": 202, "line_type": "text", "content": "ペットの健康状態を...", "position": 1 },
    { "id": 203, "line_type": "heading", "content": "# ターゲット", "position": 2 },
    { "id": 204, "line_type": "text", "content": "犬・猫を飼っている...", "position": 3 }
  ],
  "reactions": []
}

Error Responses

• 422バリデーションエラー（例: title が空）