Skip to content

发送信息接口使用说明

lykops edited this page Jan 1, 2018 · 5 revisions

仅适用于v2.1之前的版本,新版本wiki请看https://github.com/lykops/lykchat/

发送信息接口为其他业务系统发送信息给指定好友

特点

支持post和get方法
除了支持纯文字外,还支持图片、文字等诸多多媒体文件。

注意

    在2017年7月20日晚上,发现微信web端做了调整,不在显示微信号,所以即日起不能在使用微信号来发送信息
django默认启用防CSRF(Cross-site request forgery跨站请求伪造),导致无法使用post方法调用该接口,所以作者强制关闭了防csrf功能。
如果你觉得有安全隐患,又不需要发送多媒体文件,请下载2.0版本:https://codeload.github.com/lykops/lykchat/zip/master

参数说明

下面参数支持post和get方法
	'username' : 
		管理用户,同管理web页面,通过用户确认微信发送者 
	'pwd' : 
		接口密码,注意不等于登陆密码
	'type' : 
		'发送信息类型
		可选{"txt":"纯文字" ,"img":"图片","file":"发送文件","video":"视频"},可以为空
		默认:不发送文件为txt,发送文件为file
	'fromalias':
		保留字段
		发送者的微信号,目前没有使用该参数
	'friendfield':
		接受者的字段代号,可选{0:"NickName"(昵称) , 2:"RemarkName"(备注名)},可以为空
		默认为0'
	'friend':
		接受者的昵称、备注名的其中一个,不能为空
	'content':
		发送内容,不能为空
必须是post方法:
	'file':
		需要发送的文件,
注意:
	friend一定是该用户下的登陆微信好友列表中的
	friendfield可以使用昵称(NickName)或者备注名(RemarkName),但不能重复

返回信息

json格式,{'Msg': 执行结果, 'Code':返回代码, 'ErrMsg':如果-1005返回参数列表,其他发送微信返回信息}
常见code:0成功,-1101参数错误,-1102无法找到好友,1101微信号退出登录,其他为微信返回错误

使用实例

接口URL地址:http://IP(或者域名)/sendmsg
发送纯文字:
	http://192.168.100.104/sendmsg?username=zabbix&pwd=123456&friendfield=1&friend=lyk-ops&content=test
发送多媒体:
	方法1:Linux的curl命令
		curl -F "file=@/root/a" 'http://127.0.0.1/sendmsg?username=zabbix&pwd=123456&type=img&friendfield=1&friend=lyk-ops&content=test'
	方法2:python脚本test_sendfile.py
		请参照该项目的根目录python脚本test_sendfile.py,执行
		/usr/local/python36/bin/python3 /opt/lykchat/test_upload.py "{'username':'zabbix','pwd':'123456','type':'img','friendfield':'1','friend':'lyk-ops','content':'恭喜发财','file':'/root/b.jpg'}"
Clone this wiki locally