Home게임물3.0게임 API(OPEN API)게임 API 사용가이드

게임 API 사용가이드

서비스 요청 URL

http://www.grac.or.kr/WebService/GameSearchSvc.asmx

요청 변수

요청변수 필수 설명
op String game으로 입력(.Net 계열이 아닌 플랫폼에서 호출할 경우에는 op 변수를 game으로 입력하여 호출하고 .Net 플랫폼일 경우에는 웹참조를 통하여 game 함수를 호출하면 됩니다.)
gametitle String - 검색하고자 하는 게임물명
entname String - 검색하고자 하는 신청자(업체)명
rateno String - 검색하고자 하는 등급분류번호
display String 한번에 출력하는 게임물 건 수
pageno String 검색 페이지 번호. 검색결과 페이지 당 display건의 데이터가 전송되며 display건 이상의 데이터가 존재할 경우 해당 페이지 번호를 전송해야 함. 없을 경우에는 1로 전송함
* 게임물명(gmaetitle), 신청자명(entname), 등급분류번호(rateno) 중 한 항목은 반드시 입력되어야 합니다.

* .NET 환경하에서 개발할 시에는 웹참조를 통하여 호출이 가능하며 비 .NET 계열에서는 다음의 URL로 호출합니다.
http://www.grac.or.kr/WebService/GameSearchSvc.asmx/game?gametitle=[검색게임물명]&entname=[검색신청자명]&rateno=[등급분류번호]&display=10&pageno=1


출력 변수

요청변수 필수 설명
result - - 검색결과 root 요소로서 특별한 의미 없음
tcount int - 검색 결과의 갯수
res_date String(yyyy-mm-dd) - 검색결과생성일시
pageno int - 검색 페이지 번호
item String - 게임물 개별 검색 결과 root 요소로서 하위에 아래의 요소를 포함함.
gametitle String - 게임물 명
orgname String - 등급분류기관 (게임물관리위원회, 게임콘텐츠등급분류위원회)
entname String - 신청자(업체)명
hoperate String - 신청등급(전체이용가, 12세이용가, 15세이용가, 청소년이용불가)
givenrate String - 결정등급(전체이용가, 12세이용가, 15세이용가, 청소년이용불가, 등급거부(예정), 등급거부(확정), 등급취소예정, 등급취소)
rateno String - 등급분류번호(등급거부, 등급취소일 경우에는 등급분류번호가 없음)
rateddate String(yyyy-mm-dd) - 등급분류일자

오류 메세지

오류코드 메세지
0000 시스템 오류
0010 등록되지 않은 키값으로 요청하였습니다.
0011 요청 변수 중 필수값이 지정되지 않았습니다.
0013 요청 변수 중 유효하지 않은 값이 있습니다.
0020 일일 허용 검색횟수 초과 오류입니다.

출력 샘플

http://www.grac.or.kr/WebService/GameSearchSvc.asmx

실제 호출은 다음과 같습니다.
http://www.grac.or.kr/WebService/GameSearchSvc.asmx/game?gametitle=[게임물명]&entname=&rateno=&display=10&pageno=1
<?xml version="1.0" encoding="UTF-8">
<result>
      <tcount>3</tcount>
      <pageno>1</pageno>
      <res_date>2015-01-05 오전 9:00:00</res_date>
      <item>
           <gametitle>게임물명1<gametitle>
           <orgname>게임물관리위원회</orgname>
           <entname>테스트게임사</entname>
           <hoperate>전체이용가</hoperate>
           <givenrate>등급거부</givenrate>
           <rateno/>
           <rateddate>2015-01-05</rateddate>
      </item>
      <item>
           <gametitle>게임물명2<gametitle>
           <orgname>게임물관리위원회</orgname>
           <entname>테스트게임사</entname>
           <hoperate>전체이용가</hoperate>
           <givenrate>15세이용가</givenrate>
           <rateno>CC-MM-141205-xxx</rateno>
           <rateddate>2015-01-05</rateddate>
      </item>
</result>

* 오류가 발생하면 <result>가 아닌 <error>로 시작하는 다음의 메시지가 출력됩니다.
<?xml version="1.0" encoding="UTF-8">
<error>
     <message>요청 변수 중 필수값이 지정되지 않았습니다.</message>
     <error_code>0011</error_code>
</error>

정보만족도 평가

페이지의 내용이나 사용편의성
만족도에 대한 평가와 글을 남겨주세요.

현재 0/500bytes