Server List Integration

When the user enters the ONE webshop detail page, the Webshop retrieves and displays the game server list in real time.

If items must be delivered to a specific server, the developer must provide a Server List API. This API is called in real time on the Webshop detail page, and when the user completes a purchase, the selected server information is included in the PNS message.

The server list is displayed to users only if the following field is set during title registration: Developer Center > Webshop > Basic Info > Purchase Input Information = Purchase Identifier + Server

Request URI

HTTP Type	HTTPS
HTTP Method	POST
URL	You can register the server URL in Developer Center > Webshop > Integration Mgmt. For setup instructions, refer to the Integration Management Guide.
Header	Content-Type: application/json; charset=UTF-8 Accept: application/json

Request

Name	Type	Mandatory	Description
param.clientId	String	M	ONE webshop Title ID (Product ID)

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"
    }
  }'

Response

Name	Type	Mandatory	Description
result.code	String	M	"0000": Success "2000": Error
result.message	String	M
serverList[]	List	M	Server List
serverList[].serviceServerName	String	M	Server Name The server name displayed to the user. It is recommended to provide the value in a language appropriate for the target users.
serverList[].serviceServerId	String	M	Server ID

Example

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