跳转至

【移动端拨测】使用条款状态



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核对读取阶段。

文档评价

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