# Get graphics and distribute daily data in groups

Debugging Tools

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: getarticlesummary

This interface is used to obtain reading data for the day of all the group posts that have been read on a given day

# 1. How to call

# HTTPS calls

POST https://api.weixin.qq.com/datacube/getarticlesummary?access_token=ACCESS_TOKEN

# Cloud Calls

Call method: officialAccount.datacube.getArticleSummary
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 the interface belongs is: 7
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 parameters`Query String parameters`

Parameter Name	type	Required to fill in	Introductions
access_token	string	yes	Interface invocation credentials, using access_token , authorizer_access_token

# Request Body`Request Payload`

Parameter Name	type	Required to fill in	Example	Introductions
begin_date	string	yes	2023-01-01	Start date (YYYY-MM-DD)
end_date	string	yes	2023-01-01	End Date (maximum value is yesterday)

# 3. Return Parameters

# `Response Payload`

Parameter Name	type	Introductions
list	objarray	Data on all articles read during that date (including group posts only)

# Res.list(Array)`Object Payload`

Data on all articles read during that date (including group posts only)

Parameter Name	type	Introductions
ref_date	string	Date of data, between begin_date and end_date
msgid	string	Note that the msgid here is actually composed of msgid (the text message id, which is the msg_data_id returned after the call of the messaging interface) and index (the message order index), such as 12003_3, where 12003 is msgid, the id of a message sent in a queue; 3 is the index, assuming that the group of text messages a total of 5 articles (because it may be multi-text), 3 indicates the third of the 5
title	string	Graphic message title
int_page_read_user	number	Number of people who read the Graphic page (the page where you clicked on the group graphic card to get to)
int_page_read_count	number	Number of Views on the Graphic Page
ori_page_read_user	number	Number of people who read the original page (the page entered by clicking on the text page to read the original). The figure here is 0 when there is no original page
ori_page_read_count	number	Number of views of the original page
share_user	number	Number of people shared
share_count	number	Number of times shared
add_to_fav_user	number	Number of people in the collection
add_to_fav_count	number	Number of collections

# 4. Note

Data storage started from 2014-12-01, previous date data is invalid
Developers are advised to cache data locally
Images that have a combined reading of ≥ 3 will be counted
It is recommended to check the previous day's data after 8 a.m.
New communication channel fields will be added from 28 February 2020

# 5. Code examples

Example Requests

{
  "begin_date": "2014-12-08",
  "end_date": "2014-12-08"
}

Return an example

{
  "list": [
    {
      "ref_date": "2014-12-08",
      "msgid": "10000050_1",
      "title": "12月27日 DiLi日报",
      "int_page_read_user": 23676,
      "int_page_read_count": 25615,
      "ori_page_read_count": 34,
      "share_user": 122,
      "share_count": 994,
      "add_to_fav_user": 1
    }
  ]
}

# 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.
0	ok	success
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 range error	Date range exceeds interface limit

# 7. Scope of application

How this interface can be invoked under different account types:

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;