茉莉机器人介绍

  • 茉莉机器人是一个能跟用户智能交互的“人”,可以帮用户查询一些实用的资料,比如天气预报、LoL战绩、IP地址等,还拥有一些娱乐系统,比如笑话和抽签等。
  • 茉莉机器人广泛应用于各类网站的客服、QQ机器人和微信公众平台。
  • 如果您有任何疑问可以在留言反馈中提出来,或者邮件至:yyimba@qq.com

功能说明

指令大全:

指令 示例 说明 返回格式
地区天气 上海天气 查询上海的天气预报(市级或县级地区) 普通文本
天气 天气 根据访问IP自动获取天气预报 普通文本
@tq您的ip地址 @tq8.8.8.8 查询IP地址为8.8.8.8的天气预报 普通文本
@ip您的ip地址 @ip8.8.8.8 查询IP地址为8.8.8.8的位置和经纬度 普通文本
ip ip 查询访问者的IP地址详情 普通文本
@qq要查询的QQ号码 @qq123456 查询QQ号码123456的信息 普通文本
@lol英雄联盟大区--角色名称 @lol艾欧尼亚--我要超神 查询艾欧尼亚区我要超神的战绩信息 普通文本
@sfz身份证号码 @sfz111111111111111111 查询身份证号码公民所在地、生日和性别 普通文本
@sjh手机号码 @sjh18888888888 查询手机号码归属地、城市区号和卡的类型 普通文本
@cy四字成语 @cy一马当先 【一马当先】的成语接龙 普通文本
笑话 笑话 随机返回一个笑话 json
观音灵签 观音灵签 随机抽取观音灵签 json
月老灵签 月老灵签 随机抽取月老灵签 json
财神爷灵签 财神爷灵签 随机抽取财神爷灵签 json

友情提示:对API发送相应的请求时,标记的红色字符都必须有,祝您使用愉快!

快速接入

接入说明:

不使用ApiKey接入,机器人名字、对用户的称呼和一些其它信息将以代码的形式返回(比如机器人的名字用[cqname]代替的)

使用ApiKey接入(注册后可在个人中心页面查看),此时机器人名字和一些其它信息将会在个人中心的机器人设置中获取,并且会优先使用自己设置的私有词库!

接入URL:

http://i.itpk.cn/api.php

接入参数:

参数 描述 是否必选
question 对API的提问字符
limit API最大分析次数,取值范围为2-8,默认值为5,值越大精确率越高,但是会影响API响应时间
api_key 用户的Api Key
api_secret 用户的Api Secret
type 定义返回结果类型(普通文本/xml/json),暂未实现,默认普通文本

API接入例子:

不使用ApiKey:

http://i.itpk.cn/api.php?question=123

使用ApiKey和ApiSecret(api_key和api_secret两个参数必须同时携带,注册后可在个人中心查看):

http://i.itpk.cn/api.php?question=123&api_key=你的ApiKey&api_secret=你的ApiSecret

使用说明

机器人API参数说明:

  • 如果您使用ApiKey接入,那么api_keyapi_secret两个参数必须同时携带,不然不会产生效果
  • api_key固定不能修改,而api_secret是可以修改的,api_secret相当于api_key的密码
  • 如果参数quesiont为空或者错误,那么机器人API返回值将为NULL

机器人API返回值:

  • 笑话观音灵签月老灵签财神爷灵签将以JSON格式返回数据,其它的均是以普通文本返回数据!
  • [face1end][face2end]等,类似这些代码都为QQ表情(一共有170个表情,改天整理下把表情大全弄个图片)

笑话的JSON数据说明:

  • title表示笑话的标题
  • content表示笑话的内容

观音灵签的JSON数据说明:

  • number1表示签号,比如②①
  • number2也表示签号,比如二一,两种签号表示方式可任选一种
  • haohua表示此签的好坏,分上签、中签和下签三种
  • qianyu表示签语,例:阴阳道合总由天,女嫁男婚喜偎然;但见龙蛇相会合,熏熏入梦喜团圆。
  • shiyi表示诗意解签,例:此卦阴阳道合之象。凡事和合大吉也。
  • jieqian表示白话解签,例:谋望从心。婚姻孕男。资财进益。更利田蚕。
  • type表示灵签类型:观音灵签

月老灵签的JSON数据说明:

  • number1表示签号,比如①
  • number2也表示签号,比如一,两种签号表示方式可任选一种
  • haohua表示此签的好坏,有上上大吉、上吉、上中、中上等等种类
  • shiyi表示此签的诗意,例:关关雎鸠,在河之洲,窈窕淑女,君子好逑。
  • jieqian表示解签,例:春令之鸟儿啭枝头。在于河之洲。一群由冬天醒来之鸠儿歌唱。其婉转歌声。如一少女之求偶之声。......
  • zhushi表示注释,例:春木宿鸟,正好追求,男婚女嫁,月老牵成
  • baihua表示白话浅释,例:如初春鸟儿鸣唱枝头,发出求偶筑巢之美妙歌声,应当好好把握开花结果的好时机。......
  • type表示灵签类型:月老灵签

财神爷灵签的JSON数据说明:

  • number1表示签号,比如①
  • number2也表示签号,比如一,两种签号表示方式可任选一种
  • qianyu表示签语,例:日出便见风云 散光明清净照世间 一向前途通大道 万事清吉保平安
  • zhushi表示注释,例:一生清安有好尾
  • jieqian表示解签,例:功名:得意 月令:吉 求财:有利 疾病:不畏
  • jieshuo表示解说,例:只要太阳一出来。一切就会云散。只要光明一普照,世间便見清净太平。前途是光明正大。......
  • jieguo表示抽到此签,例:表示谋望难成,但不可灰心,只要契而不舍,继续追求,认真努力,自然有成功的一天。
  • hunyin表示婚姻、shiye表示事业、gongming表示功名、shiwu表示失物、cwyj表示出外移居、liujia表示六甲、qiucai表示求财
  • jiaoyi表示交易、jibin表示疾病、susong表示诉讼、yuntu表示运途、moushi表示某事、hhzsy表示合伙做生意
  • type表示灵签类型:财神爷灵签

更新日志

茉莉机器人3.1版本更新:

  1. 优化:再次重写了机器人API分析问题的算法,大大的提高回答的精确率,并且在词库的支持基础上能够联系上下文智能回答
  2. 删除:以后当机器人不知道怎么回答时,不会返回NoCk,而是从随机回复中抽取一条回答
  3. 增加:随机回复,当机器人不知道怎么回答时,从随机回复中随机抽取一条记录作为回答(注册后可以在个人中心设置,不设置系统也有默认的随机回复)
  4. 说明:以后会对参数question的字符长度做限制,最多只取前38个字符(字母、符号和中文都算一个字符),也就是超过38个字符时后面的内容会被截断
  5. 增加:指令@sjh手机号码:此指令可以查询手机号码归属地、城市区号和卡的类型
  6. 增加:指令@cy四字成语:此指令可以查询成语接龙,数据库目前已经收录42372条成语,欢迎补充

茉莉机器人3.0版本更新:

  1. 增加:参数api_keyapi_secret:当您使用它们时,机器人名字和一些其它信息将会在个人中心的机器人设置中获取,并且会优先使用自己设置的私有词库
  2. 增加:指令笑话:随机返回一个笑话,注意,为了方便用户灵活使用,这个返回的是JSON格式的数据,使用时需要您解析它
  3. 增加:指令观音灵签:随机抽取一签,共有100签,为了方便用户灵活使用,这个返回的也是JSON格式数据,使用时需要您解析它
  4. 增加:指令月老灵签:随机抽取一签,共有101签,为了方便用户灵活使用,这个返回的也是JSON格式数据,使用时需要您解析它
  5. 增加:指令财神爷灵签:随机抽取一签,共有62签,为了方便用户灵活使用,这个返回的也是JSON格式数据,使用时需要您解析它
  6. 增加:指令@sfz身份证号码:此指令可以查询身份证公民所在地、出生年月和性别
  7. 增加:指令@ipip地址:此指令可以查询某个IP地址所在地(全世界),并且能查出经纬度

茉莉机器人2.2版本更新:

  1. 增加:指令ip:查询访问者的IP地址详情
  2. 增加:指令天气:根据访问IP自动获取天气预报
  3. 增加:指令地区天气:查询某个地区的天气预报(市级或县级地区)
  4. 增加:指令@tqip地址:查询某个IP地址所在地的天气预报

茉莉机器人2.1版本更新:

  1. 优化:重写当问题中不存在权重值词语时的算法,大大的减少返回NOCK的概率
  2. 修复:lol指令无法获取部分角色的排位信息、被赞次数和被拉黑次数
  3. 增加:增加一个参数limit,用来控制API最大分析次数,取值范围为2-8,默认值为5,值越大精确率越高,但是会增加API的响应时间

茉莉机器人2.0版本更新:

  1. 优化:重写了API构建代码,方便对指令功能做更多的扩展
  2. 增加:指令@lol大区--角色,此指令可以获取英雄联盟角色的角色信息和战斗信息
  3. 增加:参数不正确或为空时返回NULL,主要是对参数question的判断
  4. 增加:返回NoCk时记录对应的问题,这个有利于我们改进机器人,希望您能够谅解

茉莉机器人1.1版本更新:

  1. 优化:优化查询算法,在保证回答的精确率上,增加了API的响应速度
  2. 增加:指令@qqQQ号码,此指令可以获取要查询QQ号码的网名和一些空间统计资料
x
提示信息
注册登录
登录注册