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
https://my.sepay.vn/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
>
>
curl -X GET "https://my.sepay.vn/api/v1/me" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
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:

401unauthorized

Token không hợp lệ hoặc hết hạn

403forbidden

Không có quyền truy cập vào tài nguyên này


Bước tiếp theo

Tiếp theo, hãy tìm hiểu về API Công ty để lấy thông tin chi tiết về công ty của người dùng.