本文枚举了火山引擎内容定制API的公共请求参数和公共响应参数,并给出了对应的详细说明。后面接口文档中,不再重复说明公共参数。
火山引擎内容定制API,除了wap注册接口外,其他接口都需要填入如下5个公共参数。
wap注册接口不需要填access_token参数,其他四个参数必填。
注意
这几个公共参数需要编码到url中,不要放到body中,否则访问会被拦截。
参数 | 描述 | 类型 | 是否必填 | 说明 |
---|---|---|---|---|
signature | 签名 | String | 是 | 参见“签名机制” |
timestamp | 10位时间戳,单位:秒 | long | 是 | 为保证安全,timestamp 与当前时间戳相关绝对值不能超过3600 秒 |
nonce | 随机数 | String | 是 | 6-12位随机字符串 |
partner | 渠道号 | String | 是 | 登录火山引擎内容定制控制台-应用管理-查看详情,查找对应“渠道号“ |
access_token | 用户身份标识 | String | 是 | 除了wap注册接口外,其他接口必填。access_token需要通过wap注册接口获取 |
参数 | 描述 | 类型 | 说明 |
---|---|---|---|
ret | 响应结果 | long | 参见“错误码”说明 |
msg | 本次请求是否成功 | String | success:成功 |
req_id | 本次请求标识 | String | 惟一标识本次请求,火山引擎侧使用该字段进行具体问题追踪和排查 |
... | 其他业务字段 | ... | 不同的接口返回的业务参数不同,具体以接口文档为准 |