界面业务规则请求外部 API 说明
请求 URL 说明
- 请求 URL:目标 URL(可在触发器模块进行目标 URL 配置)
- Method:GET
- 超时时长:30 秒
- 请求参数:
参数名称 | 参数描述 | 是否必传 | 默认值 |
---|---|---|---|
sign | 签名,参考鉴权说明 | 是 | 动态生成(不为空) |
[字段 API 名称] | 执行动作中发送字段的 API 名称 | 否 | 字段值 |
[字段 API 名称]... |
- 响应结构(JSON)
字段名称 | 字段类型 | 字段描述 | 是否必传 |
---|---|---|---|
code | number | 状态码(200:成功) | 是 |
success | string | 成功描述 | 否 |
data | object | 回传数据 | 否 |
data.record | object | 回传对象值 | 否 |
说明:回传对象值,格式如下
{
[字段API名称]:[字段值],
...
}
支持的字段类型及值类型如下:
- 单行文本:string
- 日期:string
- 日期时间:string
- 多行文本:string
- 数字:string、number
- 单选:string(选项 key 值)
- 多选:string(选项 key 值,英文逗号分隔)
- 邮箱:string
- 电话:string
- 富文本:string
- 百分比:string、number
鉴权
假设
假设 url 为:http://servicego.udesk.cn 假设 secret 为: secretabcdef123456 假设参数列表为:param1=value1,param2=value2
参数加密算法
sign 生成方法: sha1(${参数值1}&${参数值 2}&...&${sceret}) 参数值用&符连接后,再用&符连接 secret:value1&value2&secretabcdef123456,之后使用 sha1 进行加密 即:sha1(value1&value2&secretabcdef123456)=aae85378e487ca10534a81bf93c3eb33bc3d3086
结果举例
最后将参数、sign 值拼接到 url 后,如下 http://servicego.udesk.cn?param1=value1¶m2=value2&sign=aae85378e487ca10534a81bf93c3eb33bc3d3086