# Get graph reading time data

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 English name: getuserreadhour

This interface is used to obtain graph reading time data

# 1. How to call

# HTTPS calls

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

# Cloud Calls

Call method: officialAccount.datacube.getUserReadHour
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	List of data

# Res.list(Array)`Object Payload`

List of data

Parameter Name	type	Introductions
ref_date	string	Date of data, between begin_date and end_date
ref_hour	number	Data Hour
user_source	number	Where does the user enter to read the text? 99999999. All of them; 0: Session; 1. My friend; 2. WeChat Moments; 4. History message page; 5. Others; 6. Look at it. 7. Look around;
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

There are no special considerations for this interface

# 5. Code examples

Example Requests

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

Return an example

{ 
   {
   "list": [
       {
           "ref_date": "2020-02-18", 
           "ref_hour": 0, 
           "user_source": 99999999, 
           "int_page_read_user": 9028, 
           "int_page_read_count": 11815, 
           "ori_page_read_user": 0, 
           "ori_page_read_count": 0, 
           "share_user": 279, 
           "share_count": 340, 
           "add_to_fav_user": 0, 
           "add_to_fav_count": 0
       }, 
       {
           "ref_date": "2020-02-18", 
           "ref_hour": 0, 
           "user_source": 0 
           "int_page_read_user": 6812, 
           "int_page_read_count": 9172, 
           "ori_page_read_user": 0, 
           "ori_page_read_count": 0, 
           "share_user": 164, 
           "share_count": 196, 
           "add_to_fav_user": 0, 
           "add_to_fav_count": 0
       }
   ]
}

# 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

# 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;