mirror of
https://github.com/w7corp/easywechat.git
synced 2025-01-22 11:32:08 +00:00
添加文档
overtrue
parent
2f6f6a6f06
commit
78ecc23c62
4
Home.md
4
Home.md
@ -16,9 +16,13 @@
|
||||
+ [多客服的消息转发](多客服的消息转发)
|
||||
+ [网页授权](网页授权)
|
||||
+ [自定义菜单](自定义菜单)
|
||||
+ [卡券](卡券)
|
||||
+ [门店](门店)
|
||||
+ [JSSDK](JSSDK)
|
||||
+ [二维码](二维码)
|
||||
+ [短链接](短链接)
|
||||
+ [语文理解服务](语文理解服务)
|
||||
+ [数据统计查询服务](数据统计查询服务)
|
||||
|
||||
- 其它
|
||||
+ [错误处理](错误处理)
|
||||
|
||||
@ -13,9 +13,13 @@
|
||||
+ [多客服的消息转发](多客服的消息转发)
|
||||
+ [网页授权](网页授权)
|
||||
+ [自定义菜单](自定义菜单)
|
||||
+ [卡券](卡券)
|
||||
+ [门店](门店)
|
||||
+ [JSSDK](JSSDK)
|
||||
+ [二维码](二维码)
|
||||
+ [短链接](短链接)
|
||||
+ [语文理解服务](语文理解服务)
|
||||
+ [数据统计查询服务](数据统计查询服务)
|
||||
|
||||
- 其它
|
||||
+ [错误处理](错误处理)
|
||||
|
||||
2
升级日志.md
2
升级日志.md
@ -5,6 +5,8 @@
|
||||
- 【新增】二维码服务；
|
||||
- 【新增】异常消息添加中文错误消息；
|
||||
- 【新增】门店服务；
|
||||
- 【新增】语义理解服务；
|
||||
- 【新增】数据统计查询服务；
|
||||
- 【新增】素材添加完整 API 支持，支持永久素材等官方提供的所有功能；
|
||||
- 【变更】消息中图片等附件不再自动上传，之前 `media($path)` 不再接受本地文件路径，只接受上传后的 `media_id` 值，上传请先使用素材管理服务进行上传，便于素材管理；
|
||||
- 【变更】 `Wechat::service('cache')` 同样不存在了，更改为 new 服务(...), ex: `$userService = new Overtrue\Wechat\User($appId, $secret)`；
|
||||
|
||||
54
数据统计查询服务.md
Normal file
54
数据统计查询服务.md
Normal file
@ -0,0 +1,54 @@
|
||||
通过数据接口，开发者可以获取与公众平台官网统计模块类似但更灵活的数据，还可根据需要进行高级处理。
|
||||
|
||||
本 SDK 由 `Overtrue\Wechat\Stats` 提供微信数据统计查询服务。
|
||||
|
||||
> 1. 接口侧的公众号数据的数据库中仅存储了 **2014年12月1日之后**的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据；
|
||||
> 2. 请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。
|
||||
> 3. 额外注意，获取图文群发每日数据接口的结果中，只有**中间页阅读人数+原文页阅读人数+分享转发人数+分享转发次数+收藏次数 >=3** 的结果才会得到统计，过小的阅读量的图文消息无法统计。
|
||||
|
||||
### 获取实例
|
||||
|
||||
```php
|
||||
<?php
|
||||
|
||||
use Overtrue\Wechat\Stats;
|
||||
|
||||
$appId = 'wx3cf0f39249eb0e60';
|
||||
$secret = 'f1c242f4f28f735d4687abb469072a29';
|
||||
|
||||
$stats = new Stats($appId, $secret);
|
||||
```
|
||||
|
||||
## API
|
||||
|
||||
$from example: `2014-02-13` 获取数据的起始日期
|
||||
$to example: `2014-02-18` 获取数据的结束日期，`$to`允许设置的最大值为昨日
|
||||
|
||||
`$from` 和 `$to` 的差值需小于 “最大时间跨度”（比如最大时间跨度为 1 时，`$from` 和 `$to` 的差值只能为 0，才能小于 1 ），否则会报错
|
||||
|
||||
+ `array userSummary($from, $to)` 获取用户增减数据, 最大时间跨度：**7**;
|
||||
+ `array userCumulate($from, $to)` 获取累计用户数据, 最大时间跨度：**7**;
|
||||
+ `array articleSummary($from, $to)` 获取图文群发每日数据, 最大时间跨度：**1**;
|
||||
+ `array articleTotal($from, $to)` 获取图文群发总数据, 最大时间跨度：**1**;
|
||||
+ `array userReadSummary($from, $to)` 获取图文统计数据, 最大时间跨度：**3**;
|
||||
+ `array userReadHourly($from, $to)` 获取图文统计分时数据, 最大时间跨度：**1**;
|
||||
+ `array userShareSummary($from, $to)` 获取图文分享转发数据, 最大时间跨度：**7**;
|
||||
+ `array userShareHourly($from, $to)` 获取图文分享转发分时数据, 最大时间跨度：**1**;
|
||||
+ `array upstreamMesssageSummary($from, $to)` 获取消息发送概况数据, 最大时间跨度：**7**;
|
||||
+ `array upstreamMesssageHourly($from, $to)` 获取消息分送分时数据, 最大时间跨度：**1**;
|
||||
+ `array upstreamMesssageWeekly($from, $to)` 获取消息发送周数据, 最大时间跨度：**30**;
|
||||
+ `array upstreamMesssageMonthly($from, $to)` 获取消息发送月数据, 最大时间跨度：**30**;
|
||||
+ `array upstreamMesssageDistSummary($from, $to)` 获取消息发送分布数据, 最大时间跨度：**15**;
|
||||
+ `array upstreamMesssageDistWeekly($from, $to)` 获取消息发送分布周数据, 最大时间跨度：**30**;
|
||||
+ `array upstreamMesssageDistMonthly($from, $to)` 获取消息发送分布月数据, 最大时间跨度：**30**;
|
||||
+ `array interfaceSummary($from, $to)` 获取接口分析数据, 最大时间跨度：**30**;
|
||||
+ `array interfaceSummaryHourly($from, $to)` 获取接口分析分时数据, 最大时间跨度：**1**;
|
||||
|
||||
example:
|
||||
|
||||
```php
|
||||
$stats->userSummary('2014-12-07', '2014-12-08');
|
||||
|
||||
```
|
||||
|
||||
更多详细内容与协议说明，请查看微信官方文档：http://mp.weixin.qq.com/wiki/ **数据统计** 章节
|
||||
79
语义理解服务.md
Normal file
79
语义理解服务.md
Normal file
@ -0,0 +1,79 @@
|
||||
微信开放平台语义理解接口调用（http请求）简单方便，用户无需掌握语义理解及相关技术，只需根据自己的产品特点，选择相应的服务即可搭建一套智能语义服务。
|
||||
|
||||
本 SDK 由 `Overtrue\Wechat\Semantic` 提供微信语义理解服务。
|
||||
|
||||
### 获取实例
|
||||
|
||||
```php
|
||||
<?php
|
||||
|
||||
use Overtrue\Wechat\Semantic;
|
||||
|
||||
$appId = 'wx3cf0f39249eb0e60';
|
||||
$secret = 'f1c242f4f28f735d4687abb469072a29';
|
||||
|
||||
$semantic = new Semantic($appId, $secret);
|
||||
```
|
||||
|
||||
|
||||
## API
|
||||
|
||||
+ `Bag query($keyword, array | string $categories, $other = array())` 语义理解:
|
||||
|
||||
+ `$keyword` 为关键字
|
||||
+ `$categories` 需要使用的服务类型，数组或者多个用 “，” 隔开字符吕，不能为空;
|
||||
+ `$other` 为其它属性：
|
||||
+ `latitude` `float` 纬度坐标，与经度同时传入；与城市二选一传入
|
||||
+ `longitude` `float` 经度坐标，与纬度同时传入；与城市二选一传入
|
||||
+ `city` `string` 城市名称，与经纬度二选一传入
|
||||
+ `region` `string` 区域名称，在城市存在的情况下可省；与经纬度二选一传入
|
||||
+ `uid` `string` 用户唯一id（非开发者id），用户区分公众号下的不同用户（建议填入用户openid），如果为空，则无法使用上下文理解功能。appid和uid同时存在的情况下，才可以使用上下文理解功能。
|
||||
|
||||
> 注：单类别意图比较明确，识别的覆盖率比较大，所以如果只要使用特定某个类别，建议将category只设置为该类别。
|
||||
|
||||
example:
|
||||
|
||||
```php
|
||||
$result = $semantic->query('查一下明天从北京到上海的南航机票', "flight,hotel", array('city' => '北京', 'uid' => '123456'));
|
||||
// 查询参数：
|
||||
// {
|
||||
// "query":"查一下明天从北京到上海的南航机票",
|
||||
// "city":"北京",
|
||||
// "category": "flight,hotel",
|
||||
// "appid":"wxaaaaaaaaaaaaaaaa",
|
||||
// "uid":"123456"
|
||||
// }
|
||||
```
|
||||
返回值示例：
|
||||
|
||||
```json
|
||||
{
|
||||
"errcode":0,
|
||||
"query":"查一下明天从北京到上海的南航机票",
|
||||
"type":"flight",
|
||||
"semantic":{
|
||||
"details":{
|
||||
"start_loc":{
|
||||
"type":"LOC_CITY",
|
||||
"city":"北京市",
|
||||
"city_simple":"北京",
|
||||
"loc_ori":"北京"
|
||||
},
|
||||
"end_loc": {
|
||||
"type":"LOC_CITY",
|
||||
"city":"上海市",
|
||||
"city_simple":"上海",
|
||||
"loc_ori":"上海"
|
||||
},
|
||||
"start_date": {
|
||||
"type":"DT_ORI",
|
||||
"date":"2014-03-05",
|
||||
"date_ori":"明天"
|
||||
},
|
||||
"airline":"中国南方航空公司"
|
||||
},
|
||||
"intent":"SEARCH"
|
||||
}
|
||||
```
|
||||
|
||||
更多详细内容与协议说明，请查看微信官方文档：http://mp.weixin.qq.com/wiki/0/0ce78b3c9524811fee34aba3e33f3448.html
|
||||
Loading…
Reference in New Issue
Block a user