绝地求生API文档
GETTING STARTED
本文档将引导你熟悉PUBG的接口
THE URL
请求地址:包含几个部分,如下所示
"https://api.playbattlegrounds.com/shards/$platform-region-shard/players?filter[playerNames]=$player-name"
shards/$platform-region-shard - 游戏分区
players - 查询的具体后缀
filter[playerNames]=$player-name - 查询条件
AUTHORIZATION
授权:所有的接口都需要携带授权参数,授权参数在pubg开发者网站myapps中可以获得,需要将参数放在请求头header中,如下
"Authorization: Bearer $api-key"
CONTENT NEGOTIATION
内容格式:在请求的header中可以指定接口内容的格式,我们使用模式的json格式即可,在header中携带如下参数:
"Accept: application/vnd.api+json"
RATE LIMITS
访问限制:每种不同类型的开发者都有接口访问限制,默认是10/min,如果超出将返回429状态码(too many requests)
REGIONS
游戏分区:目前分为xbox和pc两种不同区,其中xbox的不需要管,pc的游戏区域共有10个
- pc-krjp - Korea(韩国)
- pc-jp - Japan(日本)
- pc-na - North America(北美)
- pc-eu - Europe(欧洲)
- pc-ru - Russia(俄罗斯)
- pc-oc - Oceania(大洋洲)
- pc-kakao - Kakao(高端)
- pc-sea - South East Asia(东南亚)
- pc-sa - South and Central America(南美)
- pc-as - Asia(亚洲)
一般的玩家在亚服比较多,默认选中的是亚服
GZIP
请求支持gzip压缩,需要在header中指定参数
"Accept-Encoding","gzip"
RESPONSE CODE
返回状态:
- 200 -请求成功
- 429 -访问超过次数限制
- 404 -未找到数据
- 401 -未授权
- 415 -请求返回数据格式不支持