跳转至

【移动端拨测】确认使用条款



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伪装成员。

文档评价

文档内容是否对您有帮助?