跳到主要内容

后台 API

鉴权​

所有接口都需要带上 validate 参数，该参数值和配置文件中的 server/validate 参数值相同。示例：

$ curl localhost:5001/history?validate=f4bde2a342c7c75aa276f78b26cfbd8a

接口返回：

{"code": 0, "message": "ok", "history": "[{\"type\": 1, \"text\": \"\\u4f1f\\u6d32 \\u4f60\\u597d\\uff01\\u8bd5\\u8bd5\\u5bf9\\u6211\\u558a\\u5524\\u9192\\u8bcd\\u53eb\\u9192\\u6211\\u5427\", \"time\": \"2019-02-07 19:10:19\", \"uuid\": \"f464d430-2ac8-11e9-bd1e-8c8590caf9a5\"}, {\"type\": 0, \"text\": \"\\u4eca\\u5929\\u5929\\u6c14\\u600e\\u4e48\\u6837\", \"time\": \"2019-02-07 19:10:33\", \"uuid\": \"fca4c218-2ac8-11e9-bd1e-8c8590caf9a5\"}, {\"type\": 1, \"text\": \"[Weather] \\u6df1\\u5733\\u5929\\u6c14\\uff1a\\u4eca\\u5929\\uff1a\\u591a\\u4e91\\uff0c20\\u523028\\u6444\\u6c0f\\u5ea6\\u3002\\u4eca\\u5929\\u5929\\u6c14\\u4e0d\\u9519\\uff0c\\u7a7a\\u6c14\\u6e05\\u65b0\\uff0c\\u9002\\u5408\\u51fa\\u95e8\\u8fd0\\u52a8\\u54e6\", \"time\": \"2019-02-07 19:10:33\", \"uuid\": \"fceec836-2ac8-11e9-bd1e-8c8590caf9a5\"}, {\"type\": 0, \"text\": \"\\u73b0\\u5728\\u51e0\\u70b9\", \"time\": \"2019-02-07 19:33:34\", \"uuid\": \"chat58b0d6a2-8395-1453-6383-4e27c421ea89\"}, {\"type\": 1, \"text\": \"2019\\u5e7402\\u670807\\u65e5 \\u661f\\u671f\\u56db \\u4e0b\\u5348 7:33\", \"time\": \"2019-02-07 19:33:35\", \"uuid\": \"3445dcd6-2acc-11e9-bd1e-8c8590caf9a5\"}]"}

管理​

用于管理 joi-ai ，包括重启/打开勿扰模式/关闭勿扰模式。

  • url：/operate
  • method: POST
  • 参数：
参数名是否必须说明
validate是参见 鉴权
type是管理类型类型。详见 管理类型取值

管理类型取值​

取值说明
0重启 joi-ai
1打开勿扰模式
2关闭勿扰模式
  • 示例：
$ curl -X POST localhost:5001/operate -d "type=restart&validate=f4bde2a342c7c75aa276f78b26cfbd8a"
  • 返回：
字段名说明
code返回码。0：成功；1：失败
message结果说明

日志​

用于查看 joi-ai 保存的日志。出于性能上的考虑，默认只返回最后 200 行的内容，相当于做了一次 tail -n 200 。

  • url：/log
  • method: GET
  • 参数：
参数名是否必须说明
validate是参见 鉴权
lines可选最大读取的日志行数。默认值为 200
  • 示例：
$ curl localhost:5001/log?validate=f4bde2a342c7c75aa276f78b26cfbd8a&lines=10
  • 返回：
字段名说明
code返回码。0：成功；1：失败
message结果说明
log日志内容

对话​

发起对话​

用于发起一次对话。

  • url：/chat
  • method: POST
  • 参数：
参数名是否必须说明
validate是参见 鉴权
type是query 类型。 "text": 文本型 query ； "voice"：语音型 query
query仅当 type 为 "text" 时需要发起对话的内容的 urlencode 后的值。例如 ”现在几点？“ 的 urlencode 结果
uuid仅当 type 为 "text" 时需要为这个文本 query 赋予的一个 uuid。例如可以使用随机字符+时间戳。
voice仅当 type 为 "voice" 时需要语音。需为 单通道，采样率为 16k 的 wav 格式语音的 base64 编码。
  • 示例：
$ curl -X POST localhost:5001/chat -d "type=text&query=%E7%8E%B0%E5%9C%A8%E5%87%A0%E7%82%B9&validate=f4bde2a342c7c75aa276f78b26cfbd8a&uuid=chated17be5d-0240-c9ba-2b2e-7eb98588cf34"
  • 返回：
参数名说明
code返回码。0：成功；1：失败
message结果说明
resp返回对话文本
audioTTS 音频的 url 地址（注意：不缓存的音频将在一分钟后被自动清理）

对话历史​

用于查看 joi-ai 启动到现在的所有会话记录。

  • url：/history
  • method: GET
  • 参数：
参数名是否必须说明
validate是参见 鉴权
  • 示例：
$ curl localhost:5001/history?validate=f4bde2a342c7c75aa276f78b26cfbd8a
  • 返回：
字段名说明
code返回码。0：成功；1：失败
message结果说明
history会话历史

配置​

查看配置​

用于查看 joi-ai 现有的配置。

  • url：/config
  • method: GET
  • 参数：
参数名是否必须说明
validate是参见 鉴权
key可选某个配置的键值。例如：robot_name_cn 。如果要多级key的对应value，则使用 /一级key/二级key/... 的形式，例如 /server/host 可以取 server 的 host 配置。
  • 示例：
$ curl localhost:5001/config?validate=f4bde2a342c7c75aa276f78b26cfbd8a\&key=server
  • 返回：
字段名说明
code返回码。0：成功；1：失败
message结果说明
config全部的配置，仅当不传 key 参数时提供
valuekey 提供的配置，仅当传 key 参数时提供；如果找不到这个 key，则返回 null

修改配置​

用于配置 joi-ai 。

  • url：/config
  • method: POST
  • 参数：
参数名是否必须说明
validate是参见 鉴权
config是配置内容，必须为 yaml 可解析的文本经过 urlencode 后的值
  • 示例：
$ curl -X localhost:5001/config -d "config=robot_name_cn%3A+'%E5%AD%99%E6%82%9F%E7%A9%BA'%0Afirst_name%3A+'%E4%BC%9F%E6%B4%B2'%0Alast_name%3A+'%E6%BD%98'%0Atimezone%3A+HKT%0Alocation%3A+'%E6%B7%B1%E5%9C%B3'%0A%0A%23+%E5%90%8E%E5%8F%B0%E7%AE%A1%E7%90%86%E7%AB%AF%0Aserver%3A%0A++++enable%3A+true%0A++++host%3A+'0.0.0.0'++%23+ip+%E5%9C%B0%E5%9D%80%0A++++port%3A+'5001'+++++%23+%E7%AB%AF%E5%8F%A3%E5%8F%B7++++%0A++++username%3A+'joi'..."
  • 返回：
字段名说明
code返回码。0：成功；1：失败
message结果说明