User Account Connect 개요
User Account Connect는 사용자의 DOSI 계정을 파트너사 서비스와 연동해 주는 API로, OAuth 2.0 Flow를 따릅니다. User Account Connect API를 사용하면 DOSI 사용자가 게임 같은 파트너사 서비스를 이용할 수 있게 됩니다.
연결 정보
| 개발 환경 | API base URI | Authorization endpoint |
|---|---|---|
| 운영 환경 | https://api.dosi.world | https://members.dosi.world |
응답 모델
User Account Connect는 HTTP 상태 코드와 API 응답 코드로 요청 처리 결과를 알려줍니다.
HTTP 상태 코드
일반적인 상태 코드는 아래 표를 참고하세요.
| HTTP 상태 코드 | 설명 |
|---|---|
| 200 OK | 요청 성공 |
| 400 Bad request | 요청이 잘못됨 |
| 401 Unauthorized | 인증 안 됨 |
| 500 Internal Server Error | 서버 오류 발생 |
오류 응답
HTTP 상태 코드별 상세 오류 정보는 응답 본문(body)에 다음 형태로 반환합니다.
{
"responseCode": "<code>",
"errorMessage": "<message>"
}
아래 표에서 responseCode 상세 정보를 확인하세요.
errorMessage는 API 실행 결과에서 확인할 수 있습니다.
| HTTP 상태 코드 | API 응답 코드 | 설명 |
|---|---|---|
| 400 | BAD_REQUEST | 형식에 맞지 않는 인자(argument)를 받음 |
| 401 | NO_AUTHORITY | |
| 500 | AUTH_API_UNKNOWN | 내부 인증 서버에 알 수 없는 오류 발생 |
| 500 | AUTH_API_SERVER_ERROR | |
| 500 | FAILED_TO_LOGOUT | |
| 500 | INVALID_CHAIN_NAME | 엑세스 토큰으로 디지털 아이템 목록 조회 시 chainName에 'realnet'이 아닌 값을 입력했음 |
| 500 | NOT_FOUND | 엑세스 토큰으로 디지털 아이템 목록 조회 시 지정한 contractId나 tokenType이 없음 |
| 500 | NOT_FOUND_MEMBER | 사용자를 조회할 수 없음 |
| 503 | MAINTENANCE | 유지보수 중이므로 요청을 처리할 수 없음 |