绝地求生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 -请求返回数据格式不支持

results matching ""

    No results matching ""