# WeChat パブリック プラットフォームは 2015 年 1 月 6 日に開始されました データ インターフェイス内部テストに招待されます。データ インターフェイスを通じて、開発者はパブリック プラットフォームの公式 Web サイトの統計モジュールと同様の、より柔軟なデータを取得でき、必要に応じて高度な処理を実行することもできます。
公式アカウントのログイン認証メカニズムの権限セット部門では、インターフェイス分析データ インターフェイスはアカウント サービス権限に属します。
すべてのパブリック アカウント開発者にデータ インターフェイスを公開する時期は、別途通知されます。
注意:
1、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据；
2、请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。
インターフェース分析データインターフェースとは、パブリックプラットフォームの公式ウェブサイトのデータ統計モジュールでインターフェース分析データを取得するために使用されるインターフェースを指します。 (ユーザー属性データインターフェイスがないなど):
| インターフェイス名 | 最大タイム スパン | インターフェイス呼び出しアドレス (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 |
##最大期間とは、インターフェイスが呼び出されたときにデータを取得できる最大の時間範囲を指します。たとえば、最大期間は 7 で、一度に最大 7 日分のデータを取得できることを意味します。 access_tokenの実際の値は「access_tokenの取得」で取得してください。
インターフェイス呼び出しリクエストの説明
インターフェイス分析データ インターフェイス (インターフェイス リスト内のすべてのインターフェイスを含む) は、次のサンプル データ パケットを対応するインターフェイスに POST する必要があります。呼び出しアドレス:
{
"begin_date": "2014-12-07",
"end_date": "2014-12-07"
}呼び出しパラメータの説明
#パラメータ | 必須かどうか | 説明 |
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 はエラー コードとその他の情報を返します。エラー コードのクエリについては、グローバル リターン コードの説明を参照してください。
