企业关键词模糊查询接口

包含两个版本接口:

  1. 模糊搜索接口
  2. 分页模糊搜索接口

1. 模糊搜索接口


使用企业名关键字模糊查询,返回相关的企业列表,包含企业概要信息

请求方式

  • 请求地址: http://api.shuidi.cn/open/company/search
  • 请求方式: GET/POST
  • 支持格式: JSON
  • 请求示例: http://api.shuidi.cn/open/company/search?pname=patest&ptime=1571990576623&vkey=2237ae09ea514c43a37ab0c57968f536&key=小桔科技

接口认证

客户每次调用接口,必需包含接入ID(pname), 安全验证码(vkey)和时间戳(ptime).

参数名称 类型 是否必填 说明  示例值
pname String 调用方唯一ID,用于身份识别 patest
ptime String 时间戳,从格林威治时间1970年01月01日00时00分00秒起至现在的时间,精确到毫秒(13位) 1571990576623
vkey String 安全验证码。使用下划线依次连接pkey、ptime、pkey,计算该字符串的MD5值完成签名.
结果为32个字符
2237ae09ea514c43a37ab0c57968f536

Java计算vkey示例:

String ptime =String.valueOf(System.currentTimeMillis());
SecureUtil.md5(pkey + "_" + ptime + "_" + pkey);

php计算vkey示例:

$vkey=md5($pkey.”_”.$ptime.”_”.$pkey)

请求参数

参数名称 类型 是否必填 说明 示例
key String 搜索关键字(公司名或社会统一信用代码) 小桔科技

响应结果

返回数据格式

所有接口返回值以JSON字符串的形式返回给调用者,JSON格式如下:

{
    "statusCode": 1,
    "statusMessage": "请求成功",
    "data": {}
}

返回JSON属性如下:

属性 说明
statusCode 返回查询结果编码
statusMessage statusCode不为1时的错误信息描述。
data 结果数据。不同接口,data的内容会有所不同。具体见各接口返回说明。

响应示例

{
    "statusCode": 1,
    "statusMessage": "请求成功",
    "data": [{
        "companyName": "小桔科技有限公司",
        "companyStatus": "正常",
        "companyCode": null,
        "legalPerson": "任灵芝",
        "establishDate": "20180419",
        "creditNo": "91610132MA6UU25M6J"
    }, {
        "companyName": "安徽小桔科技有限公司",
        "companyStatus": "正常",
        "companyCode": null,
        "legalPerson": "卫程",
        "establishDate": "20200121",
        "creditNo": "91341500MA2UGPLR8R"
    }, {
        "companyName": "杭州魔购科技有限公司",
        "companyStatus": "正常",
        "companyCode": null,
        "legalPerson": "韩振威",
        "establishDate": "20171127",
        "creditNo": "91330106MA2AYAW221"
    }, {
        "companyName": "郑州小桔科技有限公司",
        "companyStatus": "正常",
        "companyCode": null,
        "legalPerson": "程振西",
        "establishDate": "20190430",
        "creditNo": "91410102MA46P0FF43"
    }, {
        "companyName": "广州小桔科技有限公司",
        "companyStatus": "正常",
        "companyCode": null,
        "legalPerson": "周毅",
        "establishDate": "20170627",
        "creditNo": "91440101MA59PRRKXX"
    }, {
        "companyName": "北京小桔科技有限公司",
        "companyStatus": "正常",
        "companyCode": null,
        "legalPerson": "程维",
        "establishDate": "20120710",
        "creditNo": "9111010859963405XW"
    }, {
        "companyName": "北京小桔智能汽车科技有限公司",
        "companyStatus": "正常",
        "companyCode": null,
        "legalPerson": "刘海江",
        "establishDate": "20180528",
        "creditNo": "91110113MA01CF8L75"
    }, {
        "companyName": "北京小桔新能源汽车科技有限公司",
        "companyStatus": "正常",
        "companyCode": null,
        "legalPerson": "解晶晶",
        "establishDate": "20180528",
        "creditNo": "91110113MA01CF8F83"
    }, {
        "companyName": "保定小桔科技有限公司",
        "companyStatus": "正常",
        "companyCode": null,
        "legalPerson": "王森",
        "establishDate": "20180208",
        "creditNo": "91130605MA09RCQR1M"
    }, {
        "companyName": "甘肃小桔科技有限公司",
        "companyStatus": "正常",
        "companyCode": null,
        "legalPerson": "刘文泽",
        "establishDate": "20181126",
        "creditNo": "91620602MA724PMNXG"
    }]
}

输出结果字段含义

 属性名 类型 描述
companyName String 公司名称
companyStatus String 登记状态
companyCode String 注册号
legalPerson String 法定代表人
establishDate String 成立时间
creditNo String 统一社会信用码

错误编码

错误编码 说明
1 请求成功
2 未查询到数据
3 接口未授权
4 请求参数错误
30001 请求已过期
99999 系统错误

2. 分页模糊搜索接口


使用企业名关键字模糊查询,分页返回相关的企业列表,包含企业概要信息

请求方式

  • 请求地址: http://api.shuidi.cn/ic/search
  • 请求方式: GET/POST
  • 支持格式: JSON
  • 请求示例: http://api.shuidi.cn/ic/search?pname=patest&ptime=1571990576623&vkey=2237ae09ea514c43a37ab0c57968f536&key=小桔科技

接口认证

客户每次调用接口,必需包含接入ID(pname), 安全验证码(vkey)和时间戳(ptime).

参数名称 类型 是否必填 说明  示例值
pname String 调用方唯一ID,用于身份识别 patest
ptime String 时间戳,从格林威治时间1970年01月01日00时00分00秒起至现在的时间,精确到毫秒(13位) 1571990576623
vkey String 安全验证码。使用下划线依次连接pkey、ptime、pkey,计算该字符串的MD5值完成签名.
结果为32个字符
2237ae09ea514c43a37ab0c57968f536

Java计算vkey示例:

String ptime =String.valueOf(System.currentTimeMillis());
SecureUtil.md5(pkey + "_" + ptime + "_" + pkey);

php计算vkey示例:

$vkey=md5($pkey.”_”.$ptime.”_”.$pkey)

请求参数

参数名称 类型 是否必填 说明 示例
key String 搜索关键字(公司名或社会统一信用代码) 小桔科技
pageIndex Int 页码,默认第一页 1
pageSize Int 每页条数,默认为10,最大不超过10 10

响应结果

返回数据格式

所有接口返回值以JSON字符串的形式返回给调用者,JSON格式如下:

{
    "statusCode": 1,
    "statusMessage": "请求成功",
    "data": {}
}

返回JSON属性如下:

属性 说明
statusCode 返回查询结果编码
statusMessage statusCode不为1时的错误信息描述。
data 结果数据。不同接口,data的内容会有所不同。具体见各接口返回说明。

响应示例

{
  "statusCode": 1,
  "statusMessage": "请求成功",
  "data": {
    "paging": {
      "pageSize": 10,
      "pageIndex": 1,
      "totalRecords": 43373
    },
    "result": [
      {
        "companyName": "小桔科技有限公司",
        "companyStatus": "正常",
        "companyCode": "610132100288361",
        "legalPerson": "任灵芝",
        "establishDate": "20180419",
        "creditNo": "91610132MA6UU25M6J"
      },
      {
        "companyName": "安徽小桔科技有限公司",
        "companyStatus": "正常",
        "companyCode": "",
        "legalPerson": "卫程",
        "establishDate": "20200121",
        "creditNo": "91341500MA2UGPLR8R"
      },
      {
        "companyName": "广州小桔科技有限公司",
        "companyStatus": "正常",
        "companyCode": null,
        "legalPerson": "周毅",
        "establishDate": "20170627",
        "creditNo": "91440101MA59PRRKXX"
      },
      {
        "companyName": "郑州小桔科技有限公司",
        "companyStatus": "正常",
        "companyCode": null,
        "legalPerson": "程振西",
        "establishDate": "20190430",
        "creditNo": "91410102MA46P0FF43"
      },
      {
        "companyName": "北京小桔科技有限公司",
        "companyStatus": "正常",
        "companyCode": null,
        "legalPerson": "程维",
        "establishDate": "20120710",
        "creditNo": "9111010859963405XW"
      },
      {
        "companyName": "北京小桔智能汽车科技有限公司",
        "companyStatus": "正常",
        "companyCode": null,
        "legalPerson": "刘海江",
        "establishDate": "20180528",
        "creditNo": "91110113MA01CF8L75"
      },
      {
        "companyName": "北京小桔新能源汽车科技有限公司",
        "companyStatus": "正常",
        "companyCode": "110113025410190",
        "legalPerson": "解晶晶",
        "establishDate": "20180528",
        "creditNo": "91110113MA01CF8F83"
      },
      {
        "companyName": "甘肃小桔科技有限公司",
        "companyStatus": "正常",
        "companyCode": null,
        "legalPerson": "刘文泽",
        "establishDate": "20181126",
        "creditNo": "91620602MA724PMNXG"
      },
      {
        "companyName": "保定小桔科技有限公司",
        "companyStatus": "正常",
        "companyCode": "130605000094414",
        "legalPerson": "王森",
        "establishDate": "20180208",
        "creditNo": "91130605MA09RCQR1M"
      },
      {
        "companyName": "唐山小桔科技有限公司",
        "companyStatus": "正常",
        "companyCode": "130223080335471",
        "legalPerson": "周竞超",
        "establishDate": "20180426",
        "creditNo": "91130223MA0A2MP06L"
      }
    ]
  }
}

输出结果字段含义

 属性名 类型 描述
companyName String 公司名称
legalPerson String 法定代表人
establishDate String 成立时间
companyStatus String 登记状态
creditNo String 企业信用代码
companyCode String 注册号

错误编码

错误编码 说明
1 请求成功
2 未查询到数据
3 接口未授权
4 请求参数错误
30001 请求已过期
99999 系统错误

results matching ""

    No results matching ""