Bothub.AI 用户手册简体中文版
Primary version
Search…
⌃K

参数设置API

存储变量API

此API可以为用户存储环境变量,以供发送模板消息API使用。

发送请求

您可以用任意一个已经启用的API Key(怎样申请APIKey) 向Bothub发起请求,向一个手机号或一个官网账号发送一条消息。这个请求的说明如下:
请求属性
属性名
说明
地址
请求方式
POST
Header
APIKEY
您的API KEY
Form Data
request.method
需要调用的api。此处设置为set_params
Form Data
request.id
用来唯一标识此发送请求的id。由调用方生成
Form Data
request.meta
预留字段
Form Data
recipient
要发送消息的用户信息,只能指定一个用户
Form Data
settings.params
要替换的参数。形式会在下方详述。
请求样例
{
"recipient": {
"id": "7819201"
},
"settings" : {
"params": [
{
"key": "points",
"value": "20000"
},
{
"key": "prize",
"value": "Gold Medal"
}
],
},
"request": {
"method": "set_params",
"id" : "F4js0Za1",
"meta": ""
}
}

同步方式请求返回值以及异步式调用回调内容

错误码列表

返回值
内容
10000
内部错误
10001
未指定API KEY
10002
无效的API KEY
10003
未指定Request id
10004
未指定调用API的种类
10005
无效的API种类
10005
无效的API种类
10006
Bot不存在或者已经被删除
10007
未指定recipient字段
10008
recipient结构不正确
10009
无效的用户指定方式
10010
用户不存在
10011
Request id与之前的重复
10100
参数无效
18000
内部错误
19000
回调超时
21001
未定义Params字段
21002
Params结构错误

用户指定

请参见 用户指
  • 用不同的方式(比如id和email)指定的是同一个用户,参数都是设置在同一个用户上的。
  • 当根据手机号发送用户,返回用户id之后,此手机号和用户被视为同一个用户,想更新此用户的参数,此API可以指定手机号或者id,效果相同。

参数格式

params用于指定需要更新的用户变量,可以指定多个。 样例格式如下:
"params": [
{
"key": "points",
"value": "20000"
},
{
"key": "prize",
"value": "Gold Medal"
}
]
  • 可以指定多个参数。
  • 如果要设置的参数已存在,会覆盖之前的设置。
  • 若value为空串,相当于设置此值为空串(使用发送模板消息时,这个参数会被替换为空串,而不是被认为是未设置)。