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 > Main Info > Purchase Input Information = Purchase Identifier + Server

Request URI

Notice According to the ONE webshop security policy, only the HTTPS protocol and port 443 are supported. Using any other configuration may result in improper operation.

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)
signature	String	M	Signature Verification (License Key) The signature key can be found in Developer Center > Integration Mgmt. > Settings for Licensing Guide : How to review the 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": 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": "아프리카 서버"
    }
  ]
}