25 lines
670 B
Markdown
25 lines
670 B
Markdown
# Story 3.2: Reward Balance Read API
|
|
|
|
key: 3-2-reward-balance-read-api
|
|
status: drafted
|
|
phase: backend-planning
|
|
note: Non-implementasi — konvensi fields, caching, dan kontrol akses.
|
|
|
|
## Ringkasan
|
|
Endpoint read-only untuk membaca saldo reward (poin) pengguna.
|
|
|
|
## Scope Backend
|
|
- Read-only saldo poin: { userId, balance }
|
|
- Opsional: { pending, lastUpdated }
|
|
- Akses: by userId; kontrol akses disepakati
|
|
|
|
## Acceptance Gate
|
|
- Format field disetujui
|
|
- Data privacy & rate limiting disepakati
|
|
|
|
## Kontrak (Outline)
|
|
- Route: GET /api/users/{userId}/rewards/balance
|
|
- Response: 200
|
|
```
|
|
{ "userId":"u1", "balance":120, "pending":10, "lastUpdated":"2025-11-12T10:00:00Z" }
|
|
``` |