界面解析データインターフェース

# WeChat パブリック プラットフォームは 2015 年 1 月 6 日に開始されました データ インターフェイス内部テストに招待されます。データ インターフェイスを通じて、開発者はパブリック プラットフォームの公式 Web サイトの統計モジュールと同様の、より柔軟なデータを取得でき、必要に応じて高度な処理を実行することもできます。

公式アカウントのログイン認証メカニズムの権限セット部門では、インターフェイス分析データ インターフェイスはアカウント サービス権限に属します。

すべてのパブリック アカウント開発者にデータ インターフェイスを公開する時期は、別途通知されます。

注意:

1、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据；
2、请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。

インターフェース分析データインターフェースとは、パブリックプラットフォームの公式ウェブサイトのデータ統計モジュールでインターフェース分析データを取得するために使用されるインターフェースを指します。 (ユーザー属性データインターフェイスがないなど):

##

最大期間とは、インターフェイスが呼び出されたときにデータを取得できる最大の時間範囲を指します。たとえば、最大期間は 7 で、一度に最大 7 日分のデータを取得できることを意味します。 access_tokenの実際の値は「access_tokenの取得」で取得してください。

インターフェイス呼び出しリクエストの説明

インターフェイス分析データ インターフェイス (インターフェイス リスト内のすべてのインターフェイスを含む) は、次のサンプル データ パケットを対応するインターフェイスに POST する必要があります。呼び出しアドレス:

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

呼び出しパラメータの説明

インターフェイス名	最大タイム スパン	インターフェイス呼び出しアドレス (https を使用する必要があります)
Getインターフェース分析データ (getinterfacesummary)	30	https://api.weixin.qq.com/datacube/getinterfacesummary?access_token=ACCESS_TOKEN
インターフェイス分析のタイムシェアリング データを取得する (getinterfacesummaryhour)	1	https://api.weixin.qq.com/datacube/getinterfacesummaryhour?access_token=ACCESS_TOKEN

#パラメータ必須かどうか説明access_tokenはい呼び出しインターフェイス資格情報begin_date は、 がデータを取得する開始日です。begin_date と end_date の差は次のとおりです。 「最大「期間」」未満 (たとえば、最大期間が 1 の場合、begin_date と end_date の差は 0 から 1 未満までのみ可能)、そうでない場合は、エラーが報告されます end_date がデータを取得する終了日です。end_date に許可される最大値は昨日です。

戻り手順

通常の状況では、インターフェイス分析データ インターフェイスの戻り JSON データ パケットは次のとおりです。

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "callback_count": 36974, 
           "fail_count": 67, 
           "total_time_cost": 14994291, 
           "max_time_cost": 5044
       }
	//后续还有不同ref_date（在begin_date和end_date之间）的数据
   ]
}

通常の状況では、インターフェイス分析時分割データが取得されます。インターフェースの戻り JSON データ パケットは次のとおりです。

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-01", 
           "ref_hour": 0, 
           "callback_count": 331, 
           "fail_count": 18, 
           "total_time_cost": 167870, 
           "max_time_cost": 5042
       }
	//后续还有不同ref_hour的数据
   ]
}

戻りパラメーターの説明

#パラメータ説明ref_dateデータの日付ref_hourデータの時間callback_count経由でメッセージを取得した後、ユーザー メッセージに受動的に返信する回数。サーバー構成アドレスfail_count上記のアクションの失敗数total_time_costかかった合計時間を callback_count で割った値が、平均所要時間max_time_cost最大所要時間 ##エラーの場合、WeChat はエラー コードとその他の情報を返します。エラー コードのクエリについては、グローバル リターン コードの説明を参照してください。