상품 지급 API

상품 지급 API는 웹 상점에서 상품을 구매한 유저의 정보를 조회합니다.

사전 준비¶

상품 지급 API를 사용하려면 아래와 같은 콘솔 메뉴에서 상품을 지급할 대상을 선택합니다.
- 커뮤니티 & 웹 상점 > 웹 상점 > 웹 상점 설정 > 상품 지급
상품 지급 방법에 따라 제작한 API를 등록합니다.

Note

상품 지급 방법에 따른 API 제작 방법은 아래 Request Example에서 확인하세요.

게임 서버 및 채널, 캐릭터 리스트 조회¶

상품 지급 대상인 게임 서버 리스트 및 서버에 포함된 채널과 캐릭터 리스트를 조회합니다.

Request URL¶

Environment	URL
상용	https://{URL}/webstore-profile
샌드박스	https://{URL}/webstore-profile
테스트	https://{URL}/webstore-profile

Request header¶

Type	Value
Http Method	POST
Content-Type	application/json

Request parameters¶

Field	Type	Required	Description
cs_code	String	O	사용자 고유 식별자

Request example¶

{
  cs_code: "c_1234123"
}

Response data¶

Field	Type	Required	Description
result_code	Integer	O	결과 코드
result_message	String	O	결과 메세지
cs_code	String	O	사용자 고유 식별자
data	Array	O	서버 리스트
data.server_id	String	O	서버 고유 식별자
data.server_name	String	O	서버의 이름
data.channels	Array	O	서버에 포함된 채널 리스트
data.channels.channel_id	String	O	채널 고유 식별자(채널 미사용시 응답 값: “0”)
data.channels.channel_name	String	O	채널의 이름(채널 미사용시 응답 값: “-”)
data.channels.characters	Array	O	채널에 포함된 캐릭터 리스트(캐릭터 미사용시 응답값: [])
data.channels.characters.character_id	String	캐릭터 사용시 O	캐릭터 고유 식별자
data.channels.characters.character_name	String	캐릭터 사용시 O	캐릭터의 이름
data.channels.characters.character_level	String	캐릭터 사용시 O	캐릭터의 레벨(캐릭터 레벨이 없는 경우 응답값: “-”)

Response code¶

Code	Description
200	성공
500	서버 에러
-	사용자에 대한 정보 없음

Response example¶

{
  "result_code": 200,
  "result_message": "success",
  "cs_code": "c_123412341234",
  "data": [
   {
    # 서버, 채널, 캐릭터 선택 시
    "server_id": "1",
    "server_name": "Server 1",
    "channels": [{
      "channel_id": "1",
      "channel_name": "Channel 1",
      "characters": [{
        "character_id": "A",
        "character_name": "Character A",
        "character_level": "99",
      },
      {
        "character_id": "B",
        "character_name": "Character B",
        "character_level": "10",
      }]
    }]
  },
  {
    # 서버, 캐릭터 선택 시
    "server_id": "2",
    "server_name": "Server 2",
    "channels": [{
      "channel_id": "0",
      "channel_name": "-",
      "characters": [{
        "character_id": "C",
        "character_name": "Character C",
        "character_level": "11",
      },
      {
        "character_id": "D",
        "character_name": "Character E",
        "character_level": "12",
      }]
    }]
  },
  {
    # 서버, 채널 선택 시
    "server_id": "3",
    "server_name": "Server 3",
    "channels": [{
      "channel_id": "2",
      "channel_name": "Channel 2",
      "characters": []
    }]
  },
  {
    # 서버만 선택 시
    "server_id": "4",
    "server_name": "Server 4",
    "channels": [{
      "channel_id": "0",
      "channel_name": "-",
      "characters": []
    }]
  }
 ]} 
}