GET /api/search

キーワード・タグで投稿一覧（タイトル・メタデータ）を取得します。

本文を取得するには、結果中の postId を GET /api/posts/{postId} に渡してください。

リクエスト

クエリパラメータ

リクエスト例

# キーワード検索
curl "https://healthy-person-emulator.org/api/search?q=挨拶&pageSize=5"

# タグ絞り込み＋いいね順
curl "https://healthy-person-emulator.org/api/search?tags=コミュニケーション&orderby=like"

# ページング
curl "https://healthy-person-emulator.org/api/search?q=会話&page=2&pageSize=20"

レスポンス

2xx 200 OK

SearchResult オブジェクト。

レスポンス例

{
  "metadata": {
    "query": "挨拶",
    "count": 90,
    "page": 1,
    "totalPages": 9,
    "orderby": "timeDesc",
    "hasMore": true
  },
  "tagCounts": [
    { "tagName": "コミュニケーション", "count": 26 },
    { "tagName": "対人関係", "count": 23 }
  ],
  "results": [
    {
      "postId": 32172,
      "postTitle": "付き合いたい異性には自然に交際相手がいないか聞いてみると良い",
      "postUrl": "https://healthy-person-emulator.org/archives/32172",
      "postDateGmt": "2023-04-10T11:38:49.000Z",
      "countLikes": 97,
      "countDislikes": 2,
      "countComments": 9,
      "tagNames": ["恋愛", "対人関係", "人間関係"]
    }
  ]
}

GET /api/posts/{postId}

個別投稿の本文（HTML）・コメント一覧・タグ・類似投稿・前後の投稿を取得します。

リクエスト

パスパラメータ

リクエスト例

curl "https://healthy-person-emulator.org/api/posts/32172"

レスポンス

2xx 200 OK

Post オブジェクト。

4xx 400 Bad Request

postId が正の整数でない場合（非数値・0以下など）。

{ "error": "postId must be a positive integer" }

4xx 404 Not Found

該当する postId の投稿が存在しない場合。

{ "error": "Post not found" }

GET /api/openapi.json

本APIのOpenAPI 3.1.0 仕様を機械可読なJSONで返します。 コード生成ツール（openapi-generator、orval等）やAIエージェントから直接読み込めます。

curl "https://healthy-person-emulator.org/api/openapi.json"