コンシューマー向け
ユーザーレシートAPI
コンシューマー（エンドユーザー）向けのレシート管理APIです。ユーザー自身のレシート一覧・詳細取得、月間支出サマリー、レシート画像のAI解析（OCR）、レシートの保存・削除に対応しています。OAuth 2.0のuser.*スコープが必要です。
api/v1/user/receipts
在 API 參考文件中查看
端點清單
| 方法 | 路徑 | 說明 | 回應 |
|---|---|---|---|
| GET |
/api/v1/user/receipts
|
レシート一覧を取得
ログインユーザーのレシート一覧を返します。year, monthパラメータで月別フィルタが可能です。スコープ: user.receipts.read
|
200 401 403 |
| GET |
/api/v1/user/receipts/{id}
|
レシート詳細を取得
明細（アイテム）と店舗情報を含む単一レシートの詳細を返します。スコープ: user.receipts.read
|
200 404 |
| GET |
/api/v1/user/receipts/summary
|
月間支出サマリーを取得
指定月の合計金額、レシート数、カテゴリ別内訳、前月比を返します。year, monthパラメータで月を指定。スコープ: user.spending.read
|
200 401 403 |
| POST |
/api/v1/user/receipts/analyze
|
レシート画像をAI解析（OCR）
レシート画像をアップロードしてAIでデータを抽出します。保存はされません。multipart/form-dataでファイルを送信。最大5MB。スコープ: user.receipts.write
|
200 400 |
| POST |
/api/v1/user/receipts
|
レシートを保存
レシートを新規作成または更新します。multipart/form-dataで画像も同時にアップロード可能。重複レシート検出時は409を返します。スコープ: user.receipts.write
|
200 409 |
| DELETE |
/api/v1/user/receipts/{id}
|
レシートを削除
レシートを論理削除します。スコープ: user.receipts.write
|
204 404 |
端點詳細資訊
ログインユーザーのレシート一覧を返します。year, monthパラメータで月別フィルタが可能です。スコープ: user.receipts.read
完整路徑：
GET /api/v1/user/receipts
回應碼：
200
401
403
明細（アイテム）と店舗情報を含む単一レシートの詳細を返します。スコープ: user.receipts.read
完整路徑：
GET /api/v1/user/receipts/{id}
回應碼：
200
404
指定月の合計金額、レシート数、カテゴリ別内訳、前月比を返します。year, monthパラメータで月を指定。スコープ: user.spending.read
完整路徑：
GET /api/v1/user/receipts/summary
回應碼：
200
401
403
レシート画像をアップロードしてAIでデータを抽出します。保存はされません。multipart/form-dataでファイルを送信。最大5MB。スコープ: user.receipts.write
完整路徑：
POST /api/v1/user/receipts/analyze
回應碼：
200
400
レシートを新規作成または更新します。multipart/form-dataで画像も同時にアップロード可能。重複レシート検出時は409を返します。スコープ: user.receipts.write
完整路徑：
POST /api/v1/user/receipts
回應碼：
200
409
レシートを論理削除します。スコープ: user.receipts.write
完整路徑：
DELETE /api/v1/user/receipts/{id}
回應碼：
204
404
請求範例
請求
GET /api/v1/user/receipts?year=2026&month=3
Authorization: Bearer {access_token}
回應
[
{
"id": "abc-123",
"storeName": "セブンイレブン 渋谷店",
"totalAmount": 842,
"taxAmount": 76,
"category": "食費",
"paymentMethod": "現金",
"receiptDate": "2026-03-15T12:30:00",
"createdAt": "2026-03-15T12:35:00Z"
}
]