获取国家信息数据(queryMyRegion)
queryMyRegion API 基于 IP 的国家/地区识别服务, 根据玩家 IP 获取对应的国家或地区信息。
数据来源 (https://www.ipip.net/accuracy.html) 确保数据的准确性。
caution
- 由于数据源的因素 IP 和地区之间的转换不是 100% 的准确。
- 由于网络抖动或其他因素,该 API 可能无法返回结果。不建议在关键的游戏逻辑中使用它。用户还必须考虑失败情况下的默认适应策略。
- IP 和地区之间的转换关系将随着 IP 数据库中数据的更新而默认改变。如果需要 IP 和地区之间的固定转换关系,请联系 Player Network 助手。
请求示例
accountApi.queryMyRegion().then(
(res) => {
console.log(res);
}
);
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| ret | number | 返回代码 0:请求成功 !=0:请求失败,查看 msg 详细结果说明 |
| msg | string | 结果说明 |
| alpha2 | string | ISO 3166-1 国家或地区的 Alpha 2 代码。例如,CN 代表中国,AT 代表奥地利。 |
| region | string | ISO 3166-1 国家或地区的数字代码 例如 156 代表中国,040 代表奥地利 |
| timestamp | number | Unix 时间戳 |
| seq | string | 数据流消息序号 |
返回示例
{
ret: 0,
msg: "success",
alpha2: "HK",
region: "344",
seq: "1639128374-0343981578-017512-0000925611",
timestamp: 1639128374,
}