콘텐츠로 이동

웹 로그인 검증하기 v1

웹 로그인 검증하기 v1

로그인 후 로그인 정보를 검증하는 API입니다.

  • Request URL
상용 URL https://weblogin.withhive.com/verify
Sandbox URL https://sandbox-weblogin.withhive.com/verify
  • Request Header
HTTP Method POST
Content-Type application/json
  • Request Body
필드명 타입 설명 필수 여부
param string param string 값은 아래 테이블에 있는 key값으로 구성한 JSON 데이터를 URL 인코딩 후 BASE64 인코딩을 거쳐 생성합니다. Y
  • Request Body - param
필드명 타입 설명
token string 웹 로그인 v1 성공 시 응답값으로 전달받은 Token 정보.
pid string 웹 로그인 v1 성공 시 응답값으로 전달받은 Player ID 정보
  • Request Example
// JSON 객체로 구성한 param 원본. 이 JSON 객체에 URL 인코딩과 BASE64 인코딩을 차례대로 수행하여 얻은 string 값을 API 호출 시 Request Body로 사용함.
{
    "token": "1627881984263-jkx1B3GOY3EsJ",
    "pid": "20000009891"
}
// URL 인코딩과 BASE64 인코딩 결과
JTdCJTIydG9rZW4lMjIlM0ElMjIxNjI3ODgxOTg0MjYzLWpreDFCM0dPWTNFc0olMjIlMkMlMjJwaWQlMjIlM0ElMjIyMDAwMDAwOTg5MSUyMiU3RA==

// Curl 호출 예제. Request URL에 인코딩을 마친 param을 Request Body에 실어 호출함
curl -X POST https://weblogin.withhive.com/verify
   -H "Content-Type: application/json"
   -d "{'param': 'JTdCJTIydG9rZW4lMjIlM0ElMjIxNjI3ODgxOTg0MjYzLWpreDFCM0dPWTNFc0olMjIlMkMlMjJwaWQlMjIlM0ElMjIyMDAwMDAwOTg5MSUyMiU3RA=='}"
  • Response Body 검증 성공 여부를 코드로 반환합니다.
필드명 설명 타입 필수 여부
code 검증 성공 여부 int Y
code 설명
100 성공
500 로그인 내부 서버 에러(미들웨어 서버 및 DB 서버 접속 불가 등 내부 서버에러)
1050 Request Body에 있는 param 값이 Json Format이 아님.
1066 Request Body가 존재하지 않음.
2005 param 값이 존재 하지 않음.
2200 토큰이 유효하지 않음. 시간이 지났거나, 이미 검증에 사용한 토큰인 경우에 해당.
2201 검증 실패. 검증 Token 값이 일치하지 않음.
2202 검증 실패. 검증 PlayerID 값이 일치하지 않음.
  • Response Sample
{
    "code": "100";
}