WhatsApp API updateFlowJson - nxtele/http-api-document GitHub Wiki
更新流JSON
要更新指定流的流 JSON,请注意,该文件必须作为表单数据附加。
- URL:
/v1/wa/m/flows/updateFlowJson
- Method:
POST
- Content-Type:
multipart/form-data
- 需要鉴权:
是
(备注:此接口的签名算法为hex(md5(headersStr + accessSecretStr))
,计算签名时无需拼接body参数)
鉴权机制
鉴权规则请参考地址:API接口调用约定
请求参数
header参数:
参数名 |
类型 |
必选 |
示例值 |
说明 |
accessKey |
String |
是 |
fme2na3kdi3ki |
用户身份标识 |
ts |
String |
是 |
1655710885431 |
当前请求的时间戳(单位是毫秒),牛信服务端允许用户端请求最大时间误差为60秒 |
bizType |
String |
是 |
2 |
WhatsApp业务类型,取固定值“2” |
action |
String |
是 |
updateFlowJson |
WhatsApp业务操作,取固定值“updateFlowJson” |
sign |
String |
是 |
6e9506557d1f289501d333ee2c365826 |
API入参参数签名,签名算法 |
body参数:
参数名 |
类型 |
必选 |
示例值 |
说明 |
flow_id |
String |
是 |
387345730623799 |
流ID |
messaging_product |
String |
是 |
whatsapp |
发送消息的通道,应用于WhatsApp消息的发送时,值必须为“whatsapp” |
file |
file |
是 |
- |
json文件 |
请求示例
body(multipart/form-data) 参数:
messaging_product = whatsapp
flow_id= 387345730623799
file =
响应参数
参数名 |
类型 |
说明 |
code |
Integer |
结果编码 |
data |
JsonObject |
请求结果 |
message |
String |
请求结果说明 |
参数名 |
类型 |
说明 |
success |
boolean |
更新操作成功或失败 |
validation_errors |
array[object] |
流程中的错误列表,在发布流程之前必须修复所有错误 |
响应示例
成功示例
{
"code": 0,
"message": "Success",
"data": {
"success": true,
"validation_errors": []
}
}
失败示例
{
"code": 400,
"message": "updateFlowJsonByFlowId error",
"data": {
"error": {
"message": "Updating attempt failed",
"type": "OAuthException",
"code": 139001.0,
"error_subcode": 4016010.0,
"is_transient": false,
"error_user_title": "Flow can't be updated",
"error_user_msg": "Flow can only be modified in Draft status",
"fbtrace_id": "A361amdy-RWNN3LqcsqzTyi"
}
},
"traceId": "dd5bef3482a042f5b8338a76df789b31"
}
响应码说明
code |
message |
解决办法 |
0 |
请求成功 |
|
400 |
请求失败 |
请联系技术人员排除问题 |
1000~100X |
鉴权问题 |
详情查看API鉴权部分 |