Chuyển tới nội dung chính

API Hồ sơ Hội viên & Cơ chế Mã QR Định danh

Tài liệu chi tiết về thông tin tài khoản hội viên, cập nhật hồ sơ và cơ chế hiển thị / giải mã Mã QR hội viên giữa User App (zodutcan-user) và Staff App (zodutcan-staff).

1. Lấy Thông tin Hồ sơ Hội viên​

Lấy toàn bộ thông tin tài khoản, bao gồm định danh hội viên (unique_identifier), cấp bậc hiện tại, tổng doanh số và số dư tiền thưởng.

  • Method: GET
  • Endpoint: /api/{locale}/v1/member
  • Auth: auth:member_api (Bearer Token)

Response Thành công​

{
  "id": "019b8d48-97df-7177-8aa0-47f2107a8eb3",
  "name": "Nguyễn Văn A",
  "email": "nguyenvana@gmail.com",
  "phone": "0901234567",
  "unique_identifier": "M-882194",
  "avatar": "https://api-zodutcan.datacomtech.vn/storage/avatars/user-1.jpg",
  "birthday": "1992-08-15",
  "gender": "male",
  "tier": {
    "id": "019b8d48-tier-gold",
    "name": "Hạng Vàng (Gold)",
    "level": 3,
    "color": "#F59E0B",
    "profit_sharing_percentage": 5.0,
    "min_spending": 20000000
  },
  "total_spending": 28500000,
  "reward_balance": 450000,
  "referral_code": "REF090123",
  "created_at": "2026-01-10T10:00:00Z"
}

2. Cập nhật Thông tin Hồ sơ Cá nhân​

Hội viên cập nhật họ tên, ngày sinh, giới tính hoặc địa chỉ liên lạc.

  • Method: POST
  • Endpoint: /api/{locale}/v1/member/profile
  • Auth: auth:member_api (Bearer Token)

Request Body​

{
  "name": "Nguyễn Văn An",
  "birthday": "1992-08-15",
  "gender": "male",
  "address": "123 Nguyễn Huệ, Phường Bến Nghé, Quận 1, TP.HCM"
}

Response Thành công​

{
  "success": true,
  "message": "Cập nhật thông tin thành công.",
  "data": {
    "id": "019b8d48-97df-7177-8aa0-47f2107a8eb3",
    "name": "Nguyễn Văn An",
    "birthday": "1992-08-15",
    "gender": "male",
    "address": "123 Nguyễn Huệ, Phường Bến Nghé, Quận 1, TP.HCM"
  }
}