【移动端拨测】确认使用条款¶
POST /api/v1/dialing_task/mobile/terms/accept
概述¶
保留的条款确认入口;OpenAPI Key不能代替成员确认。
调用前和使用步骤¶
此公开路径保留,但控制器仅允许真实Front登录态空间Owner/管理员确认,因此使用DF-API-KEY正常调用会返回403 ft.MobileDialTermsAcceptForbidden,不存在可供Key成功确认的参数组合。请由有资格成员在产品内阅读确认后,使用查询确认状态验收。
请求示例用{},不能提供acceptedBy/acceptedAt伪造记录;本OpenAPI分支在权限检查处终止,不产生确认记录或成功审计。共享Front实现可以幂等确认及生成服务端时间/身份,这不代表当前Key入口支持该行为。
请求头¶
| 参数名 | 类型 | 必选 | 说明 |
|---|---|---|---|
| DF-API-KEY | string | Y | 工作空间的 OpenAPI 鉴权凭据。 例子: <DF-API-KEY>获取或填写方式: 从目标工作空间的 API Key 管理获取有该操作权限的 OpenAPI Key。 |
参数补充说明¶
仅登录态空间 Owner 或管理员可确认,API Key 禁止。仅接收空请求 {},不接收版本、人、时间或空间字段;重复成功保留首次人和服务器 Unix 秒 acceptedAt。
请求例子¶
curl --request POST 'https://openapi.guance.com/api/v1/dialing_task/mobile/terms/accept' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{}'
响应¶
正常OpenAPI调用返回HTTP403 JSON错误;下方展示真实拒绝结构,不声明Key调用可成功确认。
| 字段 | 类型 | 说明 |
|---|---|---|
| content | object | OpenAPI正常拒绝时为空错误内容;本route跳过declaration。 |
{
"code": 403,
"content": {},
"errorCode": "ft.MobileDialTermsAcceptForbidden",
"message": "仅登录态空间Owner或管理员可确认移动端拨测使用条款。",
"success": false,
"traceId": "TRACE-EXAMPLE"
}
错误响应¶
鉴权、限流和公共请求错误参见公共错误定义。
| HTTP 状态 | errorCode | 触发条件 | 消息或响应说明 | 处理方式 |
|---|---|---|---|---|
| 400 | ft.RequestJsonFormatError | 请求 JSON 语法无效 | 请求 JSON 格式错误 | 按 content.reason、line、column 修正 JSON。 |
| 400 | ft.JsonFormatError | Body顶层不是JSON对象,先于确认权限检查失败 | 部分 json 文件格式错误 | 按示例{}提交;有效对象仍不能使Key获得确认权限。 |
| 403 | ft.MobileDialTermsAcceptForbidden | OpenAPI身份不是合格Front登录态成员 | 仅登录态空间Owner或管理员可确认移动端拨测使用条款。 | 登录产品由空间Owner/管理员阅读确认,不通过API Key伪装成员。 |