LMS-BGN/docs/stories/3-2-reward-balance-read-api.md

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" }