微韵平台接口融合开发小文档

2016-03-31 分类：微信平台阅读(1582) 评论(0)

首先我们看看需要填写的配置信息:

名词解释:

触发关键词: 触发关键词是指用户发送那个关键词给您的微信平台,平台触发此接口

参数传递 :

是否过滤触发词
比如设置的电影为触发词,用户输入“电影美国派” 时，如果启用过滤我们只将“美国派”这个词发送到的你的接口，如果不过滤就是整个“电影美国派”全部发送到的接口!

接口类型: 我们会post 参数到本接口 Content=用户消息&fromUsername=用户加密id&toUsername=你的公众号token (目前只支持post形式~)

触发时机: 优先于所有关键词触发系统回答不上来的时候触发这两种选择

二次回复:

二次回复：不开放开放

二次回复指的是:当用户发送一个关键词触发了您的自定义接口,接下来是否需要继续把消息转发到你的接口服务器 , 如果选择开启,则会按照如下的设置及进行转发,如果不开启, 用户将只有一次与接口交互的机会.

关键词推送次数 : 指的是当你开启了二次回复前提下:

用户与接口交互几次后退出交互模式~,如果配置10,本接口被触发后,接下来用户发送的10条任何消息都将被转发到您的接口服务器,转发的数据格式如下(远数据可直接用POST接收):

JavaScript

{"fromUsername":"oIP2jxAXUKfIzaw7OeR2a6OE8FKg","Content":"666","toUsername":"svaoxy1452359789","num":"2","suid":"56fbfd5fb7f191614562fc93b74133e144321b1241b5f"}

1

{"fromUsername":"oIP2jxAXUKfIzaw7OeR2a6OE8FKg","Content":"666","toUsername":"svaoxy1452359789","num":"2","suid":"56fbfd5fb7f191614562fc93b74133e144321b1241b5f"}

分别对应为: fromUsername : 发送者的唯一openid,

Content : 发送的内容,

toUserName : 你在微韵的唯一id ,

num : 第几次推送数据到本接口,

suid : 本接口的唯一suid,唯一标识符

例如你的接口是使用php处理,那只需要在接口地址中写入

PHP

$_POST['fromUsername']

1

$_POST['fromUsername']

即可获取到发送者的唯一openid,以此类推…

开放时长(秒) : 是指本接口在一定范围nei有效,如果超出这个时间,及时次数还没调用完毕,也将退出交互

标识符：指的是你本接口在微韵平台接口间调用数据的唯一标准,用户与其他接口交互与本程序标识,

退出接口模式关键词 : 只要用户输入此关键词, 则清空本接口所有的缓存数据,直接退出才做(本接口又一次机会与用户交互)

第三方微信api地址：

第三方微信token：

后两项暂时不可用,可以不填写~~

第三方微信api地址：
第三方微信token：

以下是示例程序

接口配置如下:

接口处理程序(PHP)

PHP

<?php file_put_contents('./info.txt', json_encode($_POST)); echo json_encode(array('code'=>1,'text'=>'这是'.$_POST['num'].'次')); ?>

1
2
3
4

<?php
file_put_contents('./info.txt', json_encode($_POST));
echo json_encode(array('code'=>1,'text'=>'这是'.$_POST['num'].'次'));
?>

写入文件的数据

JavaScript

{"fromUsername":"oIP2jxAXUKfIzaw7OeR2a6OE8FKg","Content":"\u518d\u89c1","toUsername":"svaoxy1452359789","num":"2","suid":"56fbfea20f244ffb414772b2d03958423972cc4632917"}

1

{"fromUsername":"oIP2jxAXUKfIzaw7OeR2a6OE8FKg","Content":"\u518d\u89c1","toUsername":"svaoxy1452359789","num":"2","suid":"56fbfea20f244ffb414772b2d03958423972cc4632917"}

运行结果如下