服务器列表联动

当用户进入 ONE webshop 详情页时，Webshop 会实时查询并展示游戏服务器列表。

若道具需发放至特定服务器，开发者必须提供服务器列表查询 API。该 API 会在详情页实时调用，用户选择服务器并完成购买后，服务器信息会随 PNS 一同传递。

仅当在标题注册中将以下字段设置为： Developer Center > Webshop > Main Info > Purchase Input Information = Purchase Identifier + Server时，服务器列表才会向用户显示。

Request URI

HTTP Type	HTTPS
HTTP Method	POST
URL	可在 Developer Center > Webshop > Integration Mgmt. 中注册要接收通知的服务器 URL。 详细设置方法请参考《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 标题 ID（商品 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"：成功 "2000"：错误
result.message	String	M
serverList[]	List	M	服务器列表
serverList[].serviceServerName	String	M	服务器名称 向用户显示的服务器名称。 建议以适合目标用户的语言提供该值。
serverList[].serviceServerId	String	M	服务器 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": "아프리카 서버"
    }
  ]
}