Skip to Content
🚀 Welcome to Humansoft Open API Documentation

User Info

ดึงข้อมูล user จาก access token ตามมาตรฐาน OpenID Connect

Endpoint นี้ส่ง response ตรงตามมาตรฐาน OpenID Connect โดยไม่ wrap ใน {code, payload} และรับ token จาก Authorization header เท่านั้น (ไม่รับจาก body)

Endpoint

GET /oauth2/v1/userinfo Authorization: Bearer ACCESS_TOKEN

หรือ

POST /oauth2/v1/userinfo Authorization: Bearer ACCESS_TOKEN

Request Headers

HeaderRequiredDescription
AuthorizationBearer ACCESS_TOKEN

Response Format

Success Response

{ "sub": "user-credential-id", "user_id": "456", "employee_code": "EMP001", "employee_name": "John", "employee_last_name": "Doe", "employee_nickname": "JD", "first_name": "John", "last_name": "Doe", "photograph": "https://...", "email": "user@example.com" }

Fields ที่ Return ตาม Scope

Fields ที่ได้รับจะขึ้นอยู่กับ scope ที่อยู่ใน access token:

ScopeFields
(always)sub, user_id
profileemployee_code, employee_name, employee_last_name, employee_nickname, first_name, last_name, photograph
emailemail

Error Response — Missing Authorization Header

{ "error": "invalid_request", "error_description": "Missing or invalid Authorization header" }

Error Response — Invalid Token

{ "error": "invalid_token", "error_description": "Token verification failed" }

Response Fields

FieldTypeScope RequiredDescription
substring-Subject identifier (user credential ID)
user_idstring-User ID
employee_codestringprofileรหัสพนักงาน
employee_namestringprofileชื่อพนักงาน
employee_last_namestringprofileนามสกุลพนักงาน
employee_nicknamestringprofileชื่อเล่นพนักงาน
first_namestringprofileชื่อจริง
last_namestringprofileนามสกุล
photographstringprofileURL รูปภาพ profile
emailstringemailอีเมล

Code Examples

curl -X GET https://auth.humansoft.co.th/oauth2/v1/userinfo \ -H "Authorization: Bearer ACCESS_TOKEN_HERE"
Last updated on