# Server List Integration

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

{% hint style="info" %}
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`
{% endhint %}

#### **Request URI**

{% hint style="warning" %}
**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.
{% endhint %}

<table data-header-hidden><thead><tr><th width="184.9678955078125"></th><th></th></tr></thead><tbody><tr><td><strong>HTTP Type</strong></td><td>HTTPS</td></tr><tr><td><strong>HTTP Method</strong></td><td><mark style="color:$primary;"><code>POST</code></mark></td></tr><tr><td><strong>URL</strong></td><td>You can register the server URL in <code>Developer Center > Webshop > Integration Mgmt.</code><br>For setup instructions, refer to the <a href="../../webshop/integration">Integration Management</a> Guide.</td></tr><tr><td><strong>Header</strong></td><td><p>Content-Type: application/json; charset=UTF-8</p><p>Accept: application/json</p></td></tr></tbody></table>

#### **Request**

<table><thead><tr><th width="195.8836669921875">Name</th><th width="124.5450439453125">Type</th><th width="123.193603515625">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td><code>param.clientId</code></td><td>String</td><td>M</td><td>ONE webshop Title ID (Product ID)</td></tr><tr><td><code>signature</code></td><td>String</td><td>M</td><td><p>Signature Verification (License Key)</p><ul><li>The signature key can be found in <code>Developer Center > Integration Mgmt. > Settings for Licensing</code> </li><li>Guide : <a href="https://onestore-dev.gitbook.io/dev/tools/webshop/billing#id-07.pns-pushnotificationservice-signature">How to review the signature</a> </li></ul></td></tr></tbody></table>

**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**

<table><thead><tr><th width="288.869873046875">Name</th><th width="124.5450439453125">Type</th><th width="121.3316650390625">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td><code>result.code</code></td><td>String</td><td>M</td><td><p>"0000": Success</p><p>"2000": Error </p></td></tr><tr><td><code>result.message</code></td><td>String</td><td>M</td><td></td></tr><tr><td><code>serverList[]</code></td><td>List</td><td>M</td><td>Server List</td></tr><tr><td><code>serverList[].serviceServerName</code></td><td>String</td><td>M</td><td><p>Server Name</p><ul><li>The server name displayed to the user.</li><li>It is recommended to provide the value in a language appropriate for the target users.</li></ul></td></tr><tr><td><code>serverList[].serviceServerId</code></td><td>String</td><td>M</td><td>Server ID</td></tr></tbody></table>

**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": "아프리카 서버"
    }
  ]
}
```