게임짱 게임사 API 연동문서

API를 이용하기 위해 인증API ACL에 반드시 접근서버의 IP가 등록되어야 합니다.
개발 전 미리 전달해 주시기 바랍니다.

결과값은 text/json으로 리턴 되며, text는 UTF-8 입니다.

▶▶▶ 성공 ◀◀◀

구분	속성	결과값
Response Header	HTTP_CODE	200 OK
Response Body	Body	{ "Result" : "TRUE", "ResultCode" : "200", "ResultMessage" : "OK", "ResultData" : { "user_id" : "testid", "cpid" : "WEBHARD" } }

▶▶▶ 실패 ◀◀◀

구분	속성	결과값
Response Header	HTTP_CODE	400 Required
Response Body	Body	{ "Result" : "FALSE", "ResultCode" : "400", "ResultMessage" : " Required", "ResultData" : { "user_id" : "", "cpid" : "" } }

1. 사용자 인증

사용자의 로그인 여부를 체크하고, 사용자의 기본 정보를 제공하는 웹 API를 제공합니다.

1.1 사용자 정보 획득

[API URL]

http://gamejjang.com/api/loginCheck.php

[Request] 게임사 -> gamejjang (POST)

parameter	필수여부	설명
mkid	Not null	게임사코드
gid	Not null	게임코드
token	Not null	암호화된 회원정보 $_COOKIE["token"] (Get Cookie시 도메인을 반드시 확인한다.)

[Response]

parameter	parameter	설명
Result		성공 : TRUE 실패 : FALSE
ResultCode		결과코드 (하단 코드표 참조)
ResultMessage		결과메시지 성공 : OK 실패 : 에러 메시지 (Required 등)
ResultData	user_id	회원 식별 값 (아이디, 번호 외)
ResultData	cpid	매체사 코드

2. 회원 이관 처리

사용자 웹게임 가입 및 탈퇴 시 가입 유무를 저장한다.

2.1 이관완료(게임 가입) 정보 전송

[API URL]

http://gamejjang.com/api/joinDO.php

[Request] 게임사 -> gamejjang (POST)

parameter	필수여부	설명
mkid	Not null	게임사 코드(BOM, TEAM)
gid	Not null	게임 코드
cpid	Not null	매체사 코드 (ONDISK, KDISK)
uid	Not null	회원번호(사용자 인증 성공 시 전달 받는 user_id값)

[Response]

parameter	parameter	설명
Result		성공 : TRUE 실패 : FALSE
ResultCode		결과코드 (하단 코드표 참조)
ResultMessage		결과메시지 성공 : OK 실패 : 에러 메시지 (Required 등)
ResultData	user_id	회원 식별 값 (아이디, 번호 외)
ResultData	cpid	매체사 코드

2.2 이관철회(게임 탈퇴) 정보 전송

[API URL]

http://gamejjang.com/api/withdraw.php

[Request] 게임사 -> gamejjang (POST)

parameter	필수여부	설명
mkid	Not null	게임사 코드(BOM, TEAM)
gid	Not null	게임 코드
cpid	Not null	매체사 코드 (ONDISK, KDISK)
uid	Not null	회원번호(사용자 인증 성공 시 전달 받는 user_id값)

[Response]

parameter	parameter	설명
Result		성공 : TRUE 실패 : FALSE
ResultCode		결과코드 (하단 코드표 참조)
ResultMessage		결과메시지 성공 : OK 실패 : 에러 메시지 (Required 등)

3. 빌링

3.1 캐시잔액 확인

[API URL]

http://gamejjang.com/api/cashBalance.php

[Request] 게임사 -> gamejjang (POST)

parameter	필수여부	설명
mkid	Not null	게임사 코드(BOM, TEAM)
gid	Not null	게임 코드
cpid	Not null	매체사 코드 (ONDISK, KDISK)
uid	Not null	회원번호(사용자 인증 성공 시 전달 받는 user_id값)
sign	Not null	전송 할 parameter를 순서대로 문자열로 붙여 md5형태로 암호화 한 값 => md5(gid + uid + cpid + apKey) apKey 값은 메일로 전달드리도록 하겠습니다.

[Response]

parameter	parameter	설명
Result		성공 : TRUE 실패 : FALSE
ResultCode		결과코드 (하단 코드표 참조)
ResultMessage		결과메시지 성공 : OK 실패 : 에러 메시지 (Required 등)
ResultData	cashAmt	매체사 보유 cash

3.2 캐시차감 요청

[API URL]

http://gamejjang.com/api/cashPayment.php

[Request] 게임사 -> gamejjang (POST)

parameter	필수여부	설명
mkid	Not null	게임사 코드(BOM, TEAM)
gid	Not null	게임코드
cpid	Not null	매체사코드 (ONDISK, KDISK)
uid	Not null	회원번호(사용자 인증 성공 시 전달 받는 user_id값)
amt	Not null	차감요청금액
itemCode	Not null	아이템 코드
itemName	Null	아이템명
ts	Not null	결제 요청 시간(데이터 타입 : TimeStamp)
billTid	Not null	게임사 주문번호
remoteIp	Not null	결제 요청 사용자 IP
sign	Not null	전송할 parameter들을 문자열로 붙여 md5형태로 암호화 한 값, 순서가 변경되지 않게 주의하세요 => md5(gid + uid + itemCode + ts + billTid + cpid + apKey) apKey 값은 메일로 전달드리도록 하겠습니다.

[Response]

parameter	parameter	설명
Result		성공 : TRUE 실패 : FALSE
ResultCode		결과코드 (하단 코드표 참조)
ResultMessage		결과메시지 성공 : OK 실패 : 에러 메시지 (Required 등)
ResultData	tid	매체사 캐시차감 거래고유번호 에러발생 시 취소 또는 관리자 처리에 반드시 필요한 데이터 입니다.

▶▶▶ Error 코드 ◀◀◀

구분	결과값	설명
Result	100	- 오류코드 100: 회원정보 없음 101: 회원 복호화 실패 102: 회원정보 불일치
	200	성공
	300	인증 실패(IP 또는 sign 확인) - 오류코드 300: 등록된 아이피가 아닌 경우 301: 승인되지 않은 gid 302: md5암호화가 잘못된 경우, 303: ts 시간이 현재시간보다 5초 이상 느린 경우 304: billTid가 중복되는 경우, 305: 잔액부족 306: 승인되지 않은 cpid 307: 승인되지 않은 mkid
	400	필수 parameter 없음 - 오류코드 400: 필수 파라미터 값 없음 401: 토큰정보 불일치 402: 통신 오류 (CURL 통신 시 값 못 받아옴)
	500	System 오류 - 오류코드 500: 가입 이력 없음

4. UI 적용하기

4.1 GNB

<script language="JavaScript" src="http://gamejjang.com/js/ui.php"></script>

위 스크립트를 포함시키면 자동으로 상단에 GNB 메뉴 생성됩니다.

4.2 함수호출

캐시 충전

<a href="javascript:wgCashReserve( );">충전</a>

로그아웃

<a href="javascript:wgLogout( );">로그아웃</a>