Lấy thông tin người dùng

Lưu ý

Nếu ứng dụng chỉ cần lấy các thông tin cơ bản của user (tên, giới tính, avatar), bạn có thể sử dụng JS-API phía client là getUserInfo. Tuy nhiên, nấu app cần lấy thêm các thông tin khác của user (ví dụ như số điện thoại) hoặc backend cần xác thực danh tính và truy xuất thông tin một cách an toàn, hãy sử dụng Open API này.

Cấu hình Simulator

Để cấu hình cho simulator kết nối được với hệ thống lấy thông tin người dùng thì cần thiết lập cấu hình theo hướng dẫn trong phần CLI Environment để đảm bảo simulator có thể giao tiếp với các API backend một cách chính xác.

Thông tin HTTP

Key	Value
Content-Type	application/json
Method	GET
Base URL	/open/identity/v1/userinfo
Authorization	Bearer {access_token}

Scopes

Để gọi được API này, bạn cần xin access token với scope profile. Các scode bổ sung khác:

• phone: lấy thông tin số điện thoại
• email: lấy thông tin email

Ví dụ gọi API bằng cURL

curl -X GET "{baseUrl}/open/identity/v1/userinfo" \
  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \
  -H "Content-Type: application/json"

HTTP Response

Thuộc tính	Kiểu dữ liệu	Bắt buộc	Mô tả
code	number	✓	Mã trạng thái
message	string	✓	Thông báo
data	object	✓	Dữ liệu người dùng

Ví dụ phản hồi thành công

{
  "code": 0,
  "message": "Success",
  "data": {
    "user_id": "8d84e041-431a-408a-a717-ac42e451ee38",
    "name": "John Doe",
    "date_of_birth": "1990-05-15",
    "gender": "male",
    "phone_number": "+84912345678",
    "avatar_url": "https://..."
  }
}