서버 리스트 연동

사용자가 ONEshop 상세 화면에 진입하면, 실시간으로 게임 서버 목록을 조회해 노출합니다.

아이템을 특정 서버로 지급해야 하는 경우, 개발사는 서버 목록 조회 API를 제공해야 합니다. API는 ONEshop 상세 화면에서 실시간으로 호출됩니다. 사용자가 서버를 선택해 구매하면 서버 정보가 PNS로 전달됩니다.

단, 서버 목록은 ONEconsole > 웹샵 > 개발자 > 플레이어 식별 필드 메뉴에서 식별 필드 타입을 서버 리스트로 설정한 경우에만 사용자에게 표시됩니다.

Request URI

유의사항

ONEshop 보안 정책에 따라 HTTPS 프로토콜 및 443 Port만 지원합니다. 그 외 규격은 정상 동작하지 않을 수 있습니다.

HTTP Type	HTTPS
HTTP Method	POST
URL	수신 받을 서버 URL은 ONEconsole > 웹샵 > 개발자 > 서버 연동 메뉴에서 등록할 수 있습니다. 설정 방법은 연동 관리 문서를 참고해주세요.
Header	Content-Type: application/json; charset=UTF-8 Accept: application/json

Request

Name	Type	Mandatory	Description
param.clientId	String	M	원스토어 웹샵 타이틀 ID(상품 ID)
signature	String	M	위변조 방지를 위한 서명 서명키는 개발자센터 > 연동 관리 > 라이선스 관리 메뉴에서 확인할 수 있습니다. Signature 검증 방법 가이드

Example

curl -X POST "https://example.com/server-list" \
  -H "Content-Type: application/json; charset=UTF-8" \
  -H "Accept: application/json" \
  -d '{
    "param": {
      "clientId": "WS00000001"
    },
    "signature": "ajkfl;askfjkladfjksl"
  }'

Response

Name	Type	Mandatory	Description
result.code	String	M	"0000": 성공 "2000": 오류
result.message	String	M
serverList[]	List	M	서버 목록
serverList[].serviceServerName	String	M	서버 이름 사용자에게 표시되는 서버 이름입니다. 대상 사용자에게 적합한 언어로 전달하는 것을 권장합니다.
serverList[].serviceServerId	String	M	서버 ID

Example

{
  "result": {
    "code": "0000",
    "message": "ONEshop(WS00000001) servers retrieved successfully"
  },
  "serverList": [
    {
      "serviceServerId": "asia01",
      "serviceServerName": "아시아 서버"
    },
    {
      "serviceServerId": "north_america01",
      "serviceServerName": "북미 서버"
    },
    {
      "serviceServerId": "europe01",
      "serviceServerName": "유럽 서버"
    },
    {
      "serviceServerId": "africa01",
      "serviceServerName": "아프리카 서버"
    }
  ]
}