API Người dùng

Tài liệu về cách sử dụng API người dùng thông qua OAuth2 trong SePay.

Giới thiệu

API người dùng của SePay cho phép bạn truy cập thông tin về người dùng hiện tại và công ty của họ. Bạn có thể lấy thông tin cá nhân của người dùng và thông tin chi tiết về công ty mà họ thuộc về.
Để sử dụng API này, bạn cần có quyền profile (đối với thông tin người dùng) hoặc company (đối với thông tin công ty) trong phạm vi (scope) của Access Token.

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

GET

/api/v1/me

Authorization: Bearer {YOUR_ACCESS_TOKEN}

Endpoint này trả về thông tin của người dùng hiện tại đã được xác thực qua OAuth2.
Quyền yêu cầu
- Scope: profile

bash

RESPONSE

{
  "status": "success",
  "data": {
    "id": 1234,
    "first_name": "Nguyễn",
    "last_name": "Văn A",
    "email": "nguyen.van.a@example.com",
    "phone": "0901234567",
    "avatar": "https://www.gravatar.com/avatar/0bc83cb571cd1c50ba6f3e8a78ef1346"
  }
}

idinteger

ID của người dùng

first_namestring

Tên của người dùng

last_namestring

Họ của người dùng

emailstring

Địa chỉ email của người dùng

phonestring

Số điện thoại của người dùng

avatarstring

URL của avatar được lấy từ Gravatar

Mã lỗi

Dưới đây là các mã lỗi có thể gặp khi sử dụng API người dùng:

Mã Http	Mã lỗi	Mô tả
401	unauthorized	Token không hợp lệ hoặc hết hạn
403	forbidden	Không có quyền truy cập vào tài nguyên này