스토브는 OpenID를 지원합니다. 아래 내용은 OpenID 규격에 맞게 회원 정보를 가져갈 수 있는 방법에 대하여 가이드하고 있습니다.
- OpenID Connect 1.0 UserInfo Endpoint 표준 Spec에 따른 API 입니다.
- 게임 사용자 Access Token으로 회원정보를 조회합니다.
[Epic Online Services (EOS)를 사용하는 경우]
- EOS 연동 시 Identity Provider로 OpenID를 사용하려면 고객지원을 통해 수동으로 요청해야 합니다.
- 하기 고객문의 링크에 접속하여 [요청 내용] 정보를 그대로 기입하여 제출하시면 됩니다.
- (PRODUCT_ID와 DESCRIPTION은 귀하의 프로젝트 정보로 교체하셔야 합니다)
고객문의 링크: https://eoshelp.epicgames.com/s/private-question-page?language=en_US
[요청 내용]
I would like to use OpenID as an identity provider for my product.
The OpenID specification is the following:
Product ID: {PRODUCT_ID}
Description: {DESCRIPTION}
Type: UserInfo Endpoint
UserInfo API Endpoint: https://api.onstove.com/oidc/v1/userinfo
HTTP Method: GET
Name of the AccountId field: "sub"
Name of the DisplayName field: "nickname"
기본정보
GET /v1/userinfo
Host:
https://api.onstove.com/oidc (LIVE)
JavaScript
복사
Request
Header
Name | Type | Required | Default Value | Example | Description |
Authorization | String | Y | - | Bearer {user_access_token} | 사용자 인증 토큰값 |
Response
Body
Success
Name | Type | Required | Default Value | Example | Description |
sub | String | Y | - | "20005061986" | 회원 식별값
• GUID |
nickname | String | N | - | "STOVE20005061986" | 플랫폼 닉네임 |
Failure
Name | Type | Required | Default Value | Example | Description |
code | Integer | N | - | 40101 | 응답 코드 |
message | String | N | - | invalid token | 응답 메시지 |
Sample
Request
curl --location --request GET 'https://api-dev.onstove.com/oidc/v1/userinfo' \--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHBpcmVfdGltZSI6MTcxMTQzNTA2OTcyNiwibWVtYmVyX25vIjoxMDAwMDAwMDIzMjEsImFwcGxpY2F0aW9uX25vIjoxMDAwMn0.llanAiKn7TD1Z__coIGYtM_8HYc4UShNHWPYdhzyZ-B6hPPCAIiKGtwZrZyZk56EcwwzKDpCOLdzYT1wMYuBOG7L51Y29JeVjinjVCa2W-DPiumex3mo6B-wlVo_Y0SMrd2mDIsq3TQ-TlnEufFv_RnZtZ6SzYpXGmD0NyK0rvKwrp9PiEL5Rbd1jvoqyN1H2FNnne54miP5JnVUoorvLkazQQKY1bWKm91wX89oKPwlmLGQnnf_K-amylchCirM9Sl1tLOwgJamymJVUH_OPXQX9sAJzanTGfehIulEF8o'
JavaScript
복사
Response
Success
Content-Type : application/json
HTTP/ 1.1 200 OK
{
"sub": "200000000792",
"nickname": "STOVE175229625958212"
}
JSON
복사
Failure
Content-Type : application/json
// 사용자 인증 토큰이 유효하지 않은 경우
HTTP/1.1 401 Unauthorized
{
"message": "invalid token",
"code": 40101
}
// 사용자 인증 토큰이 만료된 경우
HTTP/1.1 401 Unauthorized
{
"code": 40103,
"message": "expired token"
}
JSON
복사
Return Code
HTTP Status code | Code | Message | Description |
200 | Success | ||
401 | 40101 | invalid token | 유효하지 않은 토큰
• Authorization 헤더 값이 잘못된 경우
• 사용자 인증 토큰이 아닌 경우
|
401 | 40103 | expired token | 만료된 토큰
• Authorization 헤더 값이 만료된 토큰인 경우
|