企业基本信息接口
1. 企业基本信息接口
企业基本信息接口
请求方式
- 请求地址:
http://api.shuidi.cn/open/company/base
- 请求方式:
GET/POST
- 支持格式:
JSON
- 请求示例:
http://api.shuidi.cn/open/company/base?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的内容会有所不同。具体见各接口返回说明。 |
响应示例
{
"data": {
"companyCode": "110108012660422",
"capital": "185000万",
"districtCode": "110108",
"companyType": "有限责任公司(自然人投资或控股)",
"operationEnddate": "2030-03-02 00:00:00",
"city": "北京市",
"provinceCode": "1013",
"cityCode": "110000",
"companyName": "小米科技有限责任公司",
"companyStatus": "开业",
"businessScope": "技术开发;货物进出口、技术进出口、代理进出口;销售通讯设备、厨房用品、卫生用品(含个人护理用品)、日用杂货、化妆品、医疗器械Ⅰ类、Ⅱ类、避孕器具、玩具、体育用品、文化用品、服装鞋帽、钟表眼镜、针纺织品、家用电器、家具(不从事实体店铺经营)、花、草及观赏植物、不再分装的包装种子、照相器材、工艺品、礼品、计算机、软件及辅助设备、珠宝首饰、食用农产品、宠物食品、电子产品、摩托车、电动车、自行车及零部件、智能卡、五金交电(不从事实体店铺经营)、建筑材料(不从事实体店铺经营);维修仪器仪表;维修办公设备;承办展览展示活动;会议服务;筹备、策划、组织大型庆典;设计、制作、代理、发布广告;摄影扩印服务;文艺演出票务代理、体育赛事票务代理、展览会票务代理、博览会票务代理;手机技术开发;手机生产、手机服务(限海淀区永捷北路2号二层经营);从事互联网文化活动;出版物零售;出版物批发;销售第三类医疗器械;销售食品;零售药品;广播电视节目制作;经营电信业务。(市场主体依法自主选择经营项目,开展经营活动;从事互联网文化活动、出版物批发、出版物零售、销售食品、经营电信业务、广播电视节目制作、零售药品、销售第三类医疗器械以及依法须经批准的项目,经相关部门批准后依批准的内容开展经营活动;不得从事国家和本市产业政策禁止和限制类项目的经营活动。)",
"operationStartdate": "2010-03-03 00:00:00",
"establishDate": "2010-03-03 00:00:00",
"province": "北京市",
"legalPerson": "雷军",
"companyAddress": "北京市海淀区西二旗中路33号院6号楼6层006号",
"authority": "海淀分局",
"district": "海淀区",
"creditNo": "91110108551385082Q",
"issueDate": "2020-06-04 00:00:00"
},
"statusMessage": "请求成功",
"statusCode": 1
}
输出结果字段含义
属性名 | 类型 | 含义 |
---|---|---|
companyName | String | 公司名称 |
companyType | String | 企业类型 |
legalPerson | String | 法定代表人 |
capital | String | 注册资本 |
companyCode | String | 注册码 |
companyAddress | String | 企业地址 |
businessScope | String | 经营范围 |
authority | String | 登记机关 |
companyStatus | String | 登记状态 |
establishDate | String | 成立时间 |
creditNo | String | 企业信用代码 |
province | String | 所在省份 |
operationStartdate | String | 营业日期 |
operationEnddate | String | 截止日期 |
issueDate | String | 核准时间 |
provinceCode | String | 行政区号 |
city | String | 市 |
cityCode | String | 行政区号 |
district | String | 地区 |
districtCode | String | 行政区号 |
错误编码
错误编码 | 说明 |
---|---|
1 | 请求成功 |
2 | 未查询到数据 |
3 | 接口未授权 |
4 | 请求参数错误 |
30001 | 请求已过期 |
99999 | 系统错误 |
2. 企业基本信息(含水滴落地页)
查询企业基本概要信息和水滴落地页
请求方式
- 请求地址:
http://api.shuidi.cn/open/company/base/shuidi
- 请求方式:
GET/POST
- 支持格式:
JSON
- 请求示例:
http://api.shuidi.cn/open/company/base/shuidi?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的内容会有所不同。具体见各接口返回说明。 |
响应示例
{
"data": {
"companyCode": "110108012660422",
"capital": "185000万",
"districtCode": "110108",
"companyType": "有限责任公司(自然人投资或控股)",
"operationEnddate": "2030-03-02 00:00:00",
"city": "北京市",
"provinceCode": "1013",
"cityCode": "110000",
"companyName": "小米科技有限责任公司",
"companyStatus": "开业",
"businessScope": "技术开发;货物进出口、技术进出口、代理进出口;销售通讯设备、厨房用品、卫生用品(含个人护理用品)、日用杂货、化妆品、医疗器械Ⅰ类、Ⅱ类、避孕器具、玩具、体育用品、文化用品、服装鞋帽、钟表眼镜、针纺织品、家用电器、家具(不从事实体店铺经营)、花、草及观赏植物、不再分装的包装种子、照相器材、工艺品、礼品、计算机、软件及辅助设备、珠宝首饰、食用农产品、宠物食品、电子产品、摩托车、电动车、自行车及零部件、智能卡、五金交电(不从事实体店铺经营)、建筑材料(不从事实体店铺经营);维修仪器仪表;维修办公设备;承办展览展示活动;会议服务;筹备、策划、组织大型庆典;设计、制作、代理、发布广告;摄影扩印服务;文艺演出票务代理、体育赛事票务代理、展览会票务代理、博览会票务代理;手机技术开发;手机生产、手机服务(限海淀区永捷北路2号二层经营);从事互联网文化活动;出版物零售;出版物批发;销售第三类医疗器械;销售食品;零售药品;广播电视节目制作;经营电信业务。(市场主体依法自主选择经营项目,开展经营活动;从事互联网文化活动、出版物批发、出版物零售、销售食品、经营电信业务、广播电视节目制作、零售药品、销售第三类医疗器械以及依法须经批准的项目,经相关部门批准后依批准的内容开展经营活动;不得从事国家和本市产业政策禁止和限制类项目的经营活动。)",
"operationStartdate": "2010-03-03 00:00:00",
"establishDate": "2010-03-03 00:00:00",
"province": "北京市",
"legalPerson": "雷军",
"companyAddress": "北京市海淀区西二旗中路33号院6号楼6层006号",
"authority": "海淀分局",
"district": "海淀区",
"creditNo": "91110108551385082Q",
"issueDate": "2020-06-04 00:00:00",
"url":"http://shuidi.cn/company-5cef0e5e39cd7eecd1aa6bec77b0a915.html?pa_from=217"
},
"statusMessage": "请求成功",
"statusCode": 1
}
输出结果字段含义
属性名 | 类型 | 含义 |
---|---|---|
companyName | String | 公司名称 |
companyType | String | 企业类型 |
legalPerson | String | 法定代表人 |
capital | String | 注册资本 |
companyCode | String | 注册码 |
companyAddress | String | 企业地址 |
businessScope | String | 经营范围 |
authority | String | 登记机关 |
companyStatus | String | 登记状态 |
establishDate | String | 成立时间 |
creditNo | String | 企业信用代码 |
province | String | 所在省份 |
operationStartdate | String | 营业日期 |
operationEnddate | String | 截止日期 |
issueDate | String | 核准时间 |
provinceCode | String | 行政区号 |
city | String | 市 |
cityCode | String | 行政区号 |
district | String | 地区 |
districtCode | String | 行政区号 |
url | String | 企业在水滴页面的url |
错误编码
错误编码 | 说明 |
---|---|
1 | 请求成功 |
2 | 未查询到数据 |
3 | 接口未授权 |
4 | 请求参数错误 |
30001 | 请求已过期 |
99999 | 系统错误 |
3. 企业基本信息(含联系方式)
查询企业基本概要信息和联系方式信息
请求方式
- 请求地址:
http://api.shuidi.cn/open/company/baseWithContacts
- 请求方式:
GET/POST
- 支持格式:
JSON
- 请求示例:
http://api.shuidi.cn/open/company/baseWithContacts?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": "绍兴市百岁堂酒业有限公司",
"companyCode": "330621000017519",
"creditNo": "91330602760194936R",
"orgCode": "760194936",
"legalPerson": "山柏明",
"legalPersonType": "法定代表人",
"capital": "467.000000万人民币",
"realCapital": "467.0万人民币",
"companyType": "有限责任公司(自然人投资或控股)",
"authority": "绍兴市越城区市场监督管理局",
"companyAddress": "绍兴市富盛镇乌石",
"industry": "酒、饮料和精制茶制造业",
"issueDate": "2019-06-26 00:00:00",
"businessScope": "生产:黄酒、调味料(液体)(凭有效许可证经营); 货物进出口。",
"establishDate": "2003-05-12 00:00:00",
"companyStatus": "存续",
"operationStartdate": "2003-05-12 00:00:00",
"operationEnddate": "2023-05-11 00:00:00",
"historyNames": "绍兴市山和兴酒业有限公司,绍兴市景阳酒业有限公司",
"lastUpdatedTime": "2020-08-15 14:36:12",
"province": "浙江省",
"provinceCode": "1004",
"city": "绍兴市",
"cityCode": "330600",
"district": "越城区",
"districtCode": "330602",
"contacts": {
"phoneNumber": [{
"value": "057588719797",
"note": "2013年报"
}, {
"value": "88719797",
"note": "2017年报"
}],
"email": [{
"value": "1953645164@qq.com",
"note": "2013年报"
}],
"address": [{
"value": "浙江省绍兴市越城区富盛镇乌石",
"note": "2017年报"
}, {
"value": "浙江省绍兴市越城区富盛镇乌石村",
"note": "2016年报"
}, {
"value": "浙江省绍兴市越城区富盛镇富盛镇乌石村",
"note": "2019年报"
}, {
"value": "绍兴市富盛镇乌石",
"note": "工商公示"
}],
"website": [{
"value": "www.bst-wine.cn",
"note": "百岁堂酒业"
}]
}
}
}
输出结果字段含义
属性名 | 类型 | 含义 |
---|---|---|
companyName | String | 企业名称 |
companyCode | String | 注册号 |
creditNo | String | 统一社会信用代码 |
orgCode | String | 组织机构代码 |
legalPerson | String | 法人 |
legalPersonType | String | 法人类型 |
capital | String | 注册资金 |
realCapital | String | 实收注册资金 |
companyType | String | 公司类型 |
authority | String | 登记机关 |
companyAddress | String | 注册地址 |
industry | String | 行业 |
issueDate | String | 核准时间 |
businessScope | String | 经营范围 |
establishDate | String | 成立时间 |
companyStatus | String | 经营状态 |
operationStartdate | String | 营业期限开始时间 |
operationEnddate | String | 营业期限结束时间 |
historyNames | String | 曾用名 |
lastUpdatedTime | String | 更新时间 |
contacts | Contact | 联系方式(地址、电话、邮箱、网址) |
province | String | 省份 |
provinceCode | String | 行政区号 |
city | String | 地市 |
cityCode | String | 行政区号 |
district | String | 地区 |
districtCode | String | 行政区号 |
contacts 联系方式
属性名 | 类型 | 含义 |
---|---|---|
phoneNumber.value | String | 电话号码 |
phoneNumber.note | String | 备注 |
email.value | String | 邮箱 |
email.note | String | 备注 |
address.value | String | 地址 |
address.note | String | 备注 |
website.value | String | 网址 |
website.note | String | 网站名称 |
错误编码
错误编码 | 说明 |
---|---|
1 | 请求成功 |
2 | 未查询到数据 |
3 | 接口未授权 |
4 | 请求参数错误 |
30001 | 请求已过期 |
99999 | 系统错误 |
4. 企业基本信息(含主要人员)
查询企业基本概要信息和主要人员信息
请求方式
- 请求地址:
http://api.shuidi.cn/open/company/baseWithEmployee
- 请求方式:
GET/POST
- 支持格式:
JSON
- 请求示例:
http://api.shuidi.cn/open/company/baseWithEmployee?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": "郑州中岩特种工程材料有限公司",
"companyCode": "410105000014481",
"creditNo": "",
"orgCode": null,
"legalPerson": "冯金松",
"legalPersonType": null,
"capital": "80.0万元",
"realCapital": null,
"companyType": "有限责任公司(自然人投资或控股)",
"authority": "郑州市金水区市场监督管理局",
"companyAddress": "郑州市金水区红专路128号院8号楼1单元3号",
"industry": null,
"issueDate": "2014-10-17 00:00:00",
"businessScope": "销售:建筑材料、建筑设备、五金、仪器仪表、装饰材料、自动化设备。(以上范围,国家法律、法规、规定禁止的项目及应经审批方可经营的项目除外)",
"establishDate": "2006-09-16 00:00:00",
"companyStatus": "存续(在营、开业、在册)",
"operationStartdate": "2006-09-16 00:00:00",
"operationEnddate": null,
"historyNames": null,
"lastUpdatedTime": null,
"employees": [{
"name": "冯金松",
"position": "执行董事兼总经理"
}, {
"name": "邵中军",
"position": "监事"
}],
"province": "河南省",
"provinceCode": "1021",
"city": "郑州市",
"cityCode": "410100",
"district": "金水区",
"districtCode": "410105"
}
}
输出结果字段含义
属性名 | 类型 | 含义 |
---|---|---|
companyName | String | 企业名称 |
companyCode | String | 注册号 |
creditNo | String | 统一社会信用代码 |
orgCode | String | 组织机构代码 |
legalPerson | String | 法人 |
legalPersonType | String | 法人类型 |
capital | String | 注册资金 |
realCapital | String | 实收注册资金 |
companyType | String | 公司类型 |
authority | String | 登记机关 |
companyAddress | String | 注册地址 |
industry | String | 行业 |
issueDate | String | 核准时间 |
businessScope | String | 经营范围 |
establishDate | String | 成立时间 |
companyStatus | String | 经营状态 |
operationStartdate | String | 营业期限开始时间 |
operationEnddate | String | 营业期限结束时间 |
historyNames | String | 曾用名 |
lastUpdatedTime | String | 更新时间 |
employees | Employee | 主要人员 |
province | String | 省份 |
provinceCode | String | 行政区号 |
city | String | 地市 |
cityCode | String | 行政区号 |
district | String | 地区 |
districtCode | String | 行政区号 |
employees 联系方式
属性名 | 类型 | 含义 |
---|---|---|
name | String | 名称 |
position | String | 职位 |
错误编码
错误编码 | 说明 |
---|---|
1 | 请求成功 |
2 | 未查询到数据 |
3 | 接口未授权 |
4 | 请求参数错误 |
30001 | 请求已过期 |
99999 | 系统错误 |