修改机构签署账号（通过thirdPartyUserId修改）

更新时间：2022-01-12 19:52:45

接口描述

此接口支持通过在【创建机构签署账号】接口传入的 thirdPartyUserId 更新账号信息

例如：

1. 更新机构名称，已实名的账号会变为未实名状态，需要机构重新实名；

2. 若证件号码变更，此接口不支持变更证件号，建议开发者先调用【注销机构签署账号】接口，重新创建。

接口

/v1/organizations/updateByThirdId

请求方式

POST

请求头

提供两种安全接入方式，开发者可选择其中一种方式进行对接，对应参数如何获取，参考文档【请点击】。

方式一：请求签名鉴权（优先推荐）

请求头入参示例如下：

参数名称	类型	必选	参数说明
X-Tsign-Open-App-Id	string	是	项目ID
Content-Type	string	是	application/json;charset=UTF-8
X-Tsign-Open-Ca-Timestamp	string	是	API 调用者传递时间戳，值为当前时间的毫秒数，也就是从1970年1月1日起至今的时间转换为毫秒，时间戳有效时间为15分钟，为了防重放攻击
Accept	string	是	建议统一填写 /
X-Tsign-Open-Ca-Signature	string	是	签名字符串
Content-MD5	string	否	当请求 Body 非 Form 表单时，可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时，加上此请求头。
X-Tsign-Open-Auth-Mode	string	是	选择请求方式进行鉴权，固定值，Signature

方式二：OAuth2.0鉴权（不推荐使用）

当安全接入选择OAuth2.0鉴权方式，请点击查阅详情，请求头入参示例如下：

参数名称	类型	必选	参数说明
X-Tsign-Open-App-Id	string	是	项目ID
X-Tsign-Open-Token	string	是	通过获取鉴权Token接口返回
Content-Type	string	是	application/json; charset=UTF-8

请求参数

参数名称	类型	必选	参数类型	参数说明
thirdPartyUserId	string	是	query	第三方平台机构id
name	string	否	body	机构名称
idType	string	否	body	证件类型，默认CRED_ORG_USCC （1）CRED_ORG_USCC 统一社会信用代码（2）CRED_ORG_REGCODE 工商注册号
idNumber	string	否	body	企业证件号，该字段只有为空才允许修改
orgLegalIdNumber	string	否	body	法定代表人证件号
orgLegalName	string	否	body	法定代表人名称

公共响应参数

参数名称	类型	必选	参数说明
code	int	是	业务码，0表示成功
message	string	否	信息
data	object	否	业务信息

响应参数

参数名称	类型	必选	参数说明
orgId	string	否	机构账号Id
name	string	否	机构名称
idType	string	否	证件类型（1）CRED_ORG_USCC 统一社会信用代码（2）CRED_ORG_REGCOD E工商注册号
idNumber	string	否	企业证件号
thirdPartyUserId	string	否	第三方平台机构id

请求示例

{
    "name":"xxx科技有限公司"
}

Postman请求示例

响应示例

{
    "code":0,
    "message":"成功",
    "data":{
        "name":"xxx科技有限公司",
        "creator":null,
        "orgLegalName":null,
        "orgLegalIdNumber":null,
        "orgId":"84848804142441868fd590029a5xxx",
        "idNumber":"xxxxxxxxxxxxxxxx",
        "idType":"CRED_ORG_USCC",
        "thirdPartyUserId":"20190826110230333",
        "thirdPartyUserType":"_DEFAULT_USER"
    }
}

错误码

错误描述

解决方案