企业关键词模糊查询接口
包含两个版本接口:
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 | 系统错误 |