Skip to content

协议签署

协议签署接口调用过程中,根据协议配置中的协议id,签署协议,如果用户已经签署过同一协议同一版本,则不会再签署。

请求说明

请求头

参数名中文名称必须类型描述
X-operating-sys-version调用方客户端操作系统版本Stringwindows10.1.1
X-device-fingerprint调用方客户端设备指纹String156aysdna213sc50
X-device-ip调用方客户端IPString192.168.1.2
X-agentUser-Agent信息StringMozilla/5.0 (iPhone; CPU iPhone OS 13_3 like Mac OS X)
X-L用于国际化语言设置Stringzh
X-client-id应用授权IDStringnTo1eRIub60vPb54WeE6aojPwYwImtl4
Authorization授权信息StringBearer {id_token}
content-type内容格式类型Stringapplication/json

请求示例

json
{
    "agreementIds": [
      "D8924F7071DC1D29A6822C794D848D9C",
      "DDS24F7071DC1D29A6822C794D848A1C"
    ],
    "scene":"LOGIN"
}

请求参数

参数名中文名称必须类型描述
agreementIds用户协议id集合List
scene签署场景String支持LOGIN,REGISTER

返回示例

成功示例

HTTP/1.1 200 OK

json

错误示例

HTTP/1.1 400 Bad Request

json
{
    "code": "ECS.AGREEMENT.0001",
    "data": null,
    "message": "用户协议不存在"
}

错误码

状态码错误码错误信息处理措施
400ECS.AGREEMENT.0001Agreement Id not exist请检查输入的设备信息是否完整
协议id不存在
400SDK.COMMON.1003Device information is incomplete请检查输入的设备信息是否完整
设备信息不完整
400IDAAS.SDK.PARAM.0016IdToken is invalid or expired请重新获取IdToken后再试
IdToken无效或已过期
400IDAAS.SDK.COMMON.1001Parameter {0} cannot be left blank
参数 {0} 不能为空

竹云IDaaS开放平台