メソッド:POST
エンドポイント:/works/create
📩 リクエスト項目
パラメータ名 | 型 | 必須 | 説明 |
---|---|---|---|
user_id | string | ✅ | Google OAuthのsub(ユーザー識別子) |
title | string | ✅ | プロジェクト名(最大255文字) |
description | string | ✅ | 詳細説明(最大1000文字) |
tech_stack | string | ✅ | カンマ区切り技術リスト "Next.js,TypeScript" |
screenshot_url | string | ✅ | S3の画像URL |
site_url | string | ✅ | 公開URL(https形式) |
github_url | string | ✅ | GitHub URL(https形式) |
released_on | date | ✅ | サイト公開日(YYYY-MM-DD) |
is_published | boolean | ✅ | 公開フラグ |
📤 レスポンス項目
項目名 | 型 | 必須 | 説明 |
---|---|---|---|
status | string | ✅ | "success" または "error" |
id | string | 成功時のみ必須返却 | 作成された Work の UUID(成功時) |
error.code | string | エラーコード(失敗時のみ) | |
error.message | string | エラーメッセージ(失敗時のみ) |
✅ 成功時レスポンス(例)
{ "status": "success", "id": "6e12c3ab-1111-4b21-bb9f-abcdef123456" }
❌ エラー時レスポンス(例)
{ "status": "error", "error": { "code": "INVALID_PARAM", "message": "Missing required parameters: title" } }