参数设置API

Last updated 8 months ago

存储变量API

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

发送请求

您可以用任意一个已经启用的API Key(怎样申请APIKey) 向Bothub发起请求,向一个手机号或一个官网账号发送一条消息。这个请求的说明如下:

请求属性

属性名

说明

地址

https://api.bothub.ai/api

请求方式

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": ""
}
}

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

请详见发送消息API的同名章节

错误码列表

返回值

内容

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为空串,相当于设置此值为空串(使用发送模板消息时,这个参数会被替换为空串,而不是被认为是未设置)。