人员对外投资和任职查询

根据企业名称、人员名称查询企业人员对外投资和任职查询。

一、请求说明

• 请求地址：http://api.spiderid.cn/api/router/rest，https://api.spiderid.cn/api/router/rest
• 服务接口名称(即公共参数method的值)： realid.enterprise.personRoles
• 请求方式：POST或GET

二、请求参数

• 以下参数不能都为空，请求参数以表单形式提交,Content-Type值为: application/x-www-form-urlencoded;charset=utf-8

名称	类型	是否必须	描述
entName	String	是	企业名称
personName	String	是	人员名称

请求示例：

http或https://api.spiderid.cn/api/router/rest?

entName=XXX

&personName=XXX

&<[公共请求参数]>

三、响应参数

data结果信息	类型	描述
incorrect	Integer	返回码
message	String	描述
info	String	json格式字符串，服务识别出的信息 详情见下面附录

四、成功示例

JSON示例

{
  "code": 0,
  "requestId": "ds2d24...",
  "data": {
      "message": '查询成功' ,
      "incorrect": 100 ,
      "info": ...
  },
  "message": "success"
}

五、失败示例

JSON示例

{
  "code": 0,
  "requestId": "ds2d24...",
  "data": {
      "message": '查无记录' ,
      "incorrect": 101
  },
  "message": "success"
}

六、返回码说明(incorrect)

返回码	描述	是否收费
100	查询成功	是
101	查无记录	否
102	查询失败	否

七、附录(返回数据说明)

名称	类型	描述
legalList	List	人员对外法人列表信息（详情见下表）
officeList	List	人员对外执行董事列表信息（详情见下表）
holderList	List	人员对外所占股份百分比（详情见下表）

• legalList、officeList列表字段解释

名称	类型	描述
name	String	公司名称
type	String	人员类型：法人、执行董事
establishDate	date	建立时间
regStatus	String	公司状态：注销、开业、迁出

• holderList列表字段解释

名称	类型	描述
name	String	公司名称
percent	String	股份占比
establishDate	date	建立时间
regStatus	String	公司状态：注销、开业、迁出

SDK 请求示例

    //提供的url
    String url = "http://api.spiderid.cn/api/router/rest";
    //您的appKey
    String appkey = "XXX";
    //您的appSecret
    String secretKey = "XXX";

    //企业名称
    String entName = "XXX";
    //人员名称
    String personName = "XXX";
    
    //1.原客户端
    ApiClient apiClient = new DefaultApiClient(url, appkey, secretKey);
    //2.调用出错，自动重试客户端
    //AutoRetryApiClient apiClient = new AutoRetryApiClient(url, appkey, secretKey);

    EntPersonRolesRequest req = new EntPersonRolesRequest();
    req.setEntName(entName);
    req.setPersonName(personName);

    try {
        EntPersonRolesResponse res = apiClient.execute(req);
        //后续业务处理
    } catch (ApiException e) {
        e.printStackTrace();
    }