前言

企鹅物流数据统计欢迎任何形式的 API 外部引用，但还请注意在使用我们的数据时遵循我们的数据使用协议：知识共享 署名-非商业性使用 4.0 国际。另外，虽然我们并不对我们的 API 进行频次限制（企鹅物流数据统计主站的高级查询 API 除外），但是我们依然希望您以合理的频次访问我们的 API。

联系我们

你可以以多种方式联系我们，包括：

1. 于企鹅物流数据统计主页右下角的 Crisp 客服窗口

2. Discord

3. 向站长红白发送电子邮件 alvissreimu [at] gmail.com

Post Drop

POST https://penguin-stats.io/PenguinStats/api/v2/report

This endpoint allows you to submit drop sample.

Request Body

{
  "reportHash": "49523605e1ab4774d1058d9caa25879c193226c9effee177fb3571a9f0e83e69"
}

Drop

Model

{
  dropType: string,
  itemId: string,
  quantity: number
}

Properties

dropType should be one of the four following values

• NORMAL_DROP

• SPECIAL_DROP

• EXTRA_DROP

• FURNITURE.

itemId is the internal id of item. It can be found in this repository.

quantity is the number of item dropped under this drop type. Must be positive.

Examples of Request Body

{
  "drops": [
    {
      "dropType": "SPECIAL_DROP",
      "itemId": "randomMaterial_3",
      "quantity": 1
    },
    {
      "dropType": "EXTRA_DROP",
      "itemId": "30061",
      "quantity": 2
    },
    {
      "dropType": "NORMAL_DROP",
      "itemId": "30013",
      "quantity": 1
    },
    {
      "dropType": "FURNITURE",
      "itemId": "furni",
      "quantity": 1
    }
  ],
  "stageId": "main_04-06",
  "server": "CN",
  "source": "CLIENT_SOURCE",
  "version": "CLIENT_VERSION"
}

{
  "drops": [
    {
      "dropType": "NORMAL_DROP",
      "itemId": "30063",
      "quantity": 1
    }
  ],
  "stageId": "main_06-14",
  "server": "US",
  "source": "CLIENT_SOURCE",
  "version": "CLIENT_VERSION"
}

获取 Matrix 结果

GET https://penguin-stats.io/PenguinStats/api/v2/result/matrix

此 Endpoint 允许您获取 Matrix 结果。

Query Parameters

{
  "matrix":[
    {
      "stageId":"main_01-07",
      "itemId":"30012",
      "quantity":164303,
      "times":131916,
      "start":1556676000000,
      "end":1589529600000
    },
    {
      "stageId":"main_01-07",
      "itemId":"30031",
      "quantity":7822,
      "times":131916,
      "start":1556676000000,
      "end":1589529600000
    },
    {
      "stageId":"sub_03-1-2",
      "itemId":"30032",
      "quantity":3162,
      "times":2079,
      "start":1556676000000,
      "end":1589529600000
    },
    {
      "stageId":"sub_03-1-2",
      "itemId":"randomMaterial_2",
      "quantity":20,
      "times":68,
      "start":1581105600000,
      "end":1582315200000
    }
  ]
}

什么是 Drop Matrix?

Suppose there is a matrix using stageId as row and itemId as column. Each element in the matrix represents the statistical data for that item in the stage. We will have a huge sparse matrix for all the items and stages, and for each server.

Drop Matrix 构成元素说明

Model

{
  stageId: string,
  itemId: string,
  quantity: number,
  times: number,
  start: number,
  end: number
}

Properties

stageId and itemId are internal ids of stages and items. They can be found in this repository.

start is the left end (inclusive) of the interval. Time unit is millisecond.

end is the right end (exclusive) of the interval. Time unit is millisecond.

quantity means the number of dropped items during the interval.

times means the number of times this stage was played during the interval. The value may be 0, so please be careful when calculating the drop rate.

Interval

Not all submitted drop samples will be used in the calculation of this matrix. As you can see above, each matrix element has its own interval. We design a special mechanism to decide what each interval should be.

Let's take stage main_01-07 as an example. We have four time ranges A to D:

Consider the following two items:

• 30012: Chinese name is "固源岩". It shows up in the drop list of main_01-07 across all time ranges from A to D.

• ap_supply_lt_010: Chinese name is "应急理智小样". It only shows up in the drop list of main_01-07 during time range B and D.

The calculation is assuming that the drop of ap_supply_lt_010 is independent from other items in main_01-07. The quantity and times of 30012 can be summed up across time range A to D. So the summation interval of 30012 will be A to D, which means [1556676000000, 1590696000000). Here we say all ranges for 30012 in main_01-07is accumulatable. (Maybe we should use the term "accumulable", however in the code and database we are using the former one, so we want to keep it as it is.)

For ap_supply_lt_010, we are not sure if the drop rate in time range D is different from the one in B. Thus, we think that samples from B and D should not be summed up together. We would like to say ap_supply_lt_010 in main_01-07 is non-accumulatable during time range B and D. Our matrix API is designed to reveal the latest drop rates, so the interval of ap_supply_lt_010 in main_01-07 in the matrix will be [1589529600000, 1590696000000).

Although the data of ap_supply_lt_010 in main_01-07 is not showing in the matrix result, you can still use Advanced Query to get them.

The interval may be varies for different items in one stage. That is why we show it using start and end in the drop matrix element.