接口描述
用于通过用户的组织机构名称查询其在e签宝SaaS官网的机构实名状态。
名词解释：组织机构是企业、事业单位、机关、社会团体及其他依法成立单位的统称。
接口
/v2/open/organizations/realNameInfo
请求方式
POST
请求头
方式一：请求签名鉴权（优先推荐）
当接口调用选择请求签名鉴权方式，点击查看详细说明。
参数名称 | 类型 | 必选 | 参数说明 |
X-Tsign-Open-Auth-Mode | string | 是 | 接口鉴权方式，请填写固定值Signature |
X-Tsign-Open-App-Id | string | 是 | 应用ID |
X-Tsign-Open-Ca-Signature | string | 是 | 请求签名值，查看请求签名值计算说明。 |
X-Tsign-Open-Ca-Timestamp | string | 是 | 接口调用时的Unix时间戳，单位毫秒。 防重放攻击，时间戳有效期为15分钟。 |
Content-MD5 | string | 否 | 当请求Body体为非Form格式时，需要对Body体计算ContentMD5并传给网关进行校验。 application/json格式的Body体时此项必选。 |
Content-Type | string | 是 | application/json; charset=UTF-8 |
Accept | string | 是 | 建议统一填写 */* |
方式二：OAuth2.0鉴权（不推荐使用）
当接口调用选择OAuth2.0鉴权方式，请点击查看具体请求头。
请求参数
参数名称 | 类型 | 必选 | 参数类型 | 参数说明 | |
name | string | 是 | body | 组织机构名称 | |
响应参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | |
code | int | 是 | 业务码，0表示成功 | |
message | string | 是 | 信息 | |
data | object | 否 | 业务信息 | |
name | string | 否 | 在e签宝SaaS官网中的组织机构名称 | |
realNameStatus | boolean | 否 | e签宝SaaS官网账号对应机构实名状态 true：已实名 false：未实名 | |
orgId | string | 否 | e签宝SaaS官网机构账号ID | |
请求示例
{
"name": "xxx测试企业"
}响应示例
{
"code": 0,
"message": "成功",
"data": {
"orgId": "ede017f6001e4474a355bbxxx",
"name": "xxx测试企业",
"realNameStatus": true
}
}错误码
错误码 | 错误描述 | 解决方案 |
1560002 | 账号不存在 | 请核实入参的组织机构名称是否发起过认证 |
我要纠错