realXiaoice
真正唯一可用的微软小冰API
来源为新浪微博
环境
Python 3.5+
依赖
- tornado
- requests
使用方法
1. 领养小冰
注册一个新浪微博账号，领养小冰，确保与小冰的私信是正常的
2. 登录微博账号
使用Chrome或者Firefox，建议开启隐身模式，打开 https://m.weibo.cn， 登录你的微博账号
3. 获取headers
打开和小冰的私信页面，按F12打开控制台，切换到Network，并选中XHR，然后和小冰说句话，点开名为send的请求
复制全部Request Headers中除了Content-Length以外所有行，粘贴到headers.txt中
请注意headers.txt的格式，注意大小写,Cookie和X-XSRF-TOKEN需要大写
4. 安装Python 3与依赖
安装适合自己平台的Python，需要3.5+之后的版本。为了后续兼容性考虑，选择3.6或3.7吧。然后
pip install tornado requests5. 运行
python ice_server.py6. systemd
[Unit]
Description=xiaoice API by Benny
After=network.target network-online.target nss-lookup.target
[Service]
User=nobody
Restart=on-failure
Type=simple
WorkingDirectory=/path/to/realXiaoice
ExecStart=/usr/bin/python3 /path/to/realXiaoice/ice_server.py
[Install]
WantedBy=multi-user.target
API
请求格式
接受GET、POST url-encoded-data和POST json，示例如下：
对于文字
# curl http://127.0.0.1:6789/chat?text=hello&type=text
GET http://127.0.0.1:6789/chat?text=hello&type=text
###
POST http://127.0.0.1:6789/chat
Content-Type: application/json
{
"text": "what",
"type":"text"
}
###
# curl -d 'text=hi&type=text' http://127.0.0.1:6789/chat
POST http://127.0.0.1:6789/chat
Content-Type: application/x-www-form-urlencoded
text=hi
type=text
###
对于图片(暂时只支持jpg)
# curl http://127.0.0.1:6789/chat?text=/tmp/test.jpg&type=img
GET http://127.0.0.1:6789/chat?text=/tmp/test.jpg&type=img
###
POST http://127.0.0.1:6789/chat
Content-Type: application/json
{
"text": "/tmp/test.jpg",
"type":"img"
}
###
# curl -d "text=/tmp/test.jpg&typt=img" http://127.0.0.1:6789/chat
POST http://127.0.0.1:6789/chat
Content-Type: application/x-www-form-urlencoded
text=/tmp/test.jpg
type=img
###
更多详情请参考 api.http
响应格式
成功
HTTP 200
{
"text": "想我干嘛",
"debug": ""
}参数错误
HTTP 400
{
"text": "",
"debug": "client wrong reason"
}服务端错误
HTTP 500
{
"text": "",
"debug": "server wrong reason"
}效果图
附加功能
IP地址访问限制
默认关闭，只允许某几个IP访问可以使用如下方式
python ice_server.py -a=127.0.0.1,1.1.1.1授权码限制
默认关闭，编辑key.txt一行一个添加授权码，或者运行keygen.py自动生成
开启方式
python ice_server --auth请求时需要在参数中携带auth，例如：
curl http://127.0.0.1/chat?text=hello&auth=123456Credits
License
MIT