상품 지급 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	사용자 고유 식별자

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	캐릭터의 레벨(캐릭터 레벨이 없는 경우 응답값: “-”)

Result Code¶

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

Request Example¶

# Request Parameters
{
  cs_code: "c_1234123"
}

# Response
{
  "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": []
    }]
  }
 ]} 
}