# Get summary data on passive responses
Interface should be called on the server side, not in the front end (Weixin Mini Program, web pages, APP, etc.) directly called, specific reference interface call guide
Interface name: getinterfacesummary
This interface is used to obtain passive response summary data
# 1. How to call
# HTTPS calls
POST https://api.weixin.qq.com/datacube/getinterfacesummary?access_token=ACCESS_TOKEN
# Cloud Calls
Call method: officialAccount.datacube.getInterfaceSummary
The input and exit parameters are the same as the HTTPS call, which can be called in the cloud call documentation
# Third party invocation
This interface supports Third Party Platform generation business call.
The permission set id to which this interface belongs is: 3
When a service provider is authorized by one of the permissions set, it can call on behalf of the merchant by using authorizer_access_token , which can be viewed in the third-party call documentation.
# 2. Request parameters
# Query parametersQuery String parameters
| Parameter Name | type | Required to fill in | Introductions |
|---|---|---|---|
| access_token | string | yes | Interface invocation credentials, using access_token , authorizer_access_token |
# Request BodyRequest Payload
| Parameter Name | type | Required to fill in | Example | Introductions |
|---|---|---|---|---|
| begin_date | string | yes | 2014-12-07 | Start date (YYYY-MM-DD format) |
| end_date | string | yes | 2014-12-07 | End date (maximum time span of 30 days) |
# 3. Return Parameters
# Response Payload
| Parameter Name | type | Introductions |
|---|---|---|
| list | object | List of data |
# Res.listObject Payload
List of data
| Parameter Name | type | Introductions |
|---|---|---|
| ref_date | string | Date of data |
| callback_count | number | Number of times a user message was reactively replied to after a message was obtained through the server configuration address |
| fail_count | number | Number of failures of the above actions |
| total_time_cost | number | Total time, divided by callback_count is the average time |
| max_time_cost | number | Maximum time consumption |
# 4. Note
- Querying data after December 1, 2014 is only supported
- It is recommended to check the previous day's data after 8am each day
- Ask developers to cache data themselves to reduce interface loss
# 5. Code examples
Example Requests
{
"begin_date": "2014-12-07",
"end_date": "2014-12-07"
}
Return an example
{
"list": [
{
"ref_date": "2014-12-07",
"callback_count": 36974,
"fail_count": 67,
"total_time_cost": 14994291,
"max_time_cost": 5044
}
]
}
# 6. Error code
The following is a list of error codes for this interface, other error codes can refer to General error codes
| Error code | Error Description | Solutions |
|---|---|---|
| -1 | system error | The system is busy, so the developer is asked to try again in a few minutes. |
| 40001 | invalid credential access_token isinvalid or not latest | AppSecret error while getting access_token, or access_token is invalid.Developers should check that AppSecret is correct, or that they are calling interfaces for the appropriate Official Account |
| 61500 | date format error | Date format error |
| 61501 | date range error | The difference between begin_date and end_date exceeds the maximum span |
| 61503 | data not ready please try later | Data has not yet been generated |
# 7. Scope of application
| Official Account | Service Account |
|---|---|
| Certification only | Certification only |
- Authentication only: means that only authenticated accounts are allowed to be invoked by the enterprise entity, and accounts that are not authenticated or do not support authentication cannot be invoked.
- Other account types that are not expressly stated may not be called on this interface without special instructions;