【移动端拨测】使用条款状态¶
GET /api/v1/dialing_task/mobile/terms
概述¶
查询移动拨测使用条款的空间确认状态。
调用前和使用步骤¶
OpenAPI身份允许查询;accepted表示有效服务端确认记录,不是平台开关状态。canAccept对API Key恒为false。无有效记录时accepted=false/acceptance=null;旧通用配置或重复/损坏记录不当作同意。
本请求不接受条款、不创建任务,也不初始化移动平台;不受移动拨测开关关闭直接禁止。需登录产品后由空间Owner/管理员阅读并确认,再查询accepted=true。不能把Key授予管理员角色当成登录用户的确认行为。
请求头¶
| 参数名 | 类型 | 必选 | 说明 |
|---|---|---|---|
| DF-API-KEY | string | Y | 工作空间的 OpenAPI 鉴权凭据。 例子: <DF-API-KEY>获取或填写方式: 从目标工作空间的 API Key 管理获取有该操作权限的 OpenAPI Key。 |
参数补充说明¶
空间从鉴权上下文取得。仅返回 accepted/canAccept/acceptance;未确认 acceptance=null,确认记录仅含 acceptedBy 与服务端 Unix 秒 acceptedAt。API Key 仅查自身空间且不能确认;无条款地址、语言、产品版本配置。
请求例子¶
curl --get 'https://openapi.guance.com/api/v1/dialing_task/mobile/terms' \
-H 'DF-API-KEY: <DF-API-KEY>'
响应¶
HTTP200 JSON;本route显式跳过declaration,content中无该字段。
| 字段 | 类型 | 说明 |
|---|---|---|
| content.accepted | boolean | 当前空间是否存在服务端核实的有效确认。 |
| content.canAccept | boolean | 当前身份能否确认;OpenAPI身份固定false,不能按API Key角色伪造登录成员身份。 |
| content.acceptance | object 或 null | 确认记录,未确认/重复/损坏历史记录时null。 |
| content.acceptance.acceptedBy | string | 实际确认的登录成员acnt_ UUID,不是本API Key。 |
| content.acceptance.acceptedAt | integer | 服务端确认Unix秒。 |
{
"code": 200,
"content": {
"accepted": false,
"canAccept": false,
"acceptance": null
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
错误响应¶
鉴权、限流和公共请求错误参见公共错误定义。
| HTTP 状态 | errorCode | 触发条件 | 消息或响应说明 | 处理方式 |
|---|---|---|---|---|
| 403 | ft.Forbidden | 当前调用身份不允许查询条款(OpenAPI正常身份满足) | 您无权限操作 | 使用目标空间有效OpenAPI Key,勿使用其他分享/非成员凭据。 |
| 401 | ft.WKSPNotExistOrReleased | 当前空间不存在/已释放 | 工作空间不存在/或已释放 | 核对有效空间。 |
| 500 | ft.InternalServerError | 存储读取、历史配置或本地静态映射格式化异常 | 内部错误 | 缩小至具体任务/模板或筛选,持续失败保留traceId核对读取阶段。 |