本 API は フロントエンドで Zod によるバリデーションを前提としており、

正常系では必ず object / array を返すことを保証します。

存在しないリソースに対しては 404 エラーを返し、undefined は返しません。


共通仕様

成功時

エラー時

ステータス 内容
400 リクエスト不正
401 認証エラー
404 リソースが存在しない
500 サーバーエラー

投稿一覧取得

GET /posts

Response

{
"posts":[
{
"id":1,
"title":"記事タイトル",
"body":"本文",
"status":"published",
"imageKey":"uploads/xxx.png",
"signedUrl":"https://...",
"urlExpiresAt":"2026-01-04T02:44:24.000Z",
"createdAt":"2025-03-11T21:35:37.000Z",
"updatedAt":"2026-01-04T02:44:24.000Z",
"user":{
"id":3,
"name":"aka",
"iconUrl":"uploads/icon.png",
"iconSignedUrl":"https://..."
},
"categories":[
{
"id":1,
"name":"Tech"
}
]
}
]
}


投稿詳細取得