特殊企业基本信息接口
查询特殊企业基本信息,主要包含香港公司、社会组织、律所、事业单位、基金会等
请求方式
- 请求地址:
http://api.shuidi.cn/open/ic/org/basic
- 请求方式:
GET/POST
- 支持格式:
JSON
- 请求示例:
http://api.shuidi.cn/open/ic/org/basic?pname=patest&ptime=1571990576623&vkey=2237ae09ea514c43a37ab0c57968f536&companyName=北京大学
接口认证
客户每次调用接口,必需包含接入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)
请求参数
参数名称 | 类型 | 是否必填 | 说明 | 示例 |
---|---|---|---|---|
companyName | String | 是 | 公司名 | 北京大学 |
响应结果
返回数据格式
所有接口返回值以JSON字符串的形式返回给调用者,JSON格式如下:
{ "statusCode": 1, "statusMessage": "请求成功", "data": {} }
返回JSON属性如下:
属性 | 说明 |
---|---|
statusCode | 返回查询结果编码 |
statusMessage | statusCode不为1时的错误信息描述。 |
data | 结果数据。不同接口,data的内容会有所不同。具体见各接口返回说明。 |
响应示例
{
"statusCode": 1,
"statusMessage": "请求成功",
"data": {
"orgName": "北京大学",
"creditNo": "12100000400002259P",
"orgNumber": null,
"orgType": "事业单位",
"capital": "252689万元",
"establishDate": null,
"legalPersonName": "郝平",
"base": "gj",
"address": "北京市海淀区颐和园路5号",
"certificateDept": "国家事业单位登记管理局",
"industry": null,
"authority": "教育部",
"expireDate": null
}
}
输出结果字段含义
属性名 | 类型 | 含义 |
---|---|---|
orgName | String | 组织机构名称 |
creditNo | String | 统一社会信用代码 |
orgNumber | String | 组织机构代码 |
orgType | String | 机构类型 |
capital | String | 注册资本(万元) |
establishDate | String | 注册日期 |
legalPersonName | String | 法人代表姓名 |
base | String | 行政区划 |
address | String | 机构地址 |
certificateDept | String | 办证机构 |
industry | String | 经济行业名称 |
authority | String | 上级主管部门 |
expireDate | String | 代码证作废日期 |
错误编码
错误编码 | 说明 |
---|---|
1 | 请求成功 |
2 | 未查询到数据 |
3 | 接口未授权 |
4 | 请求参数错误 |
30001 | 请求已过期 |
99999 | 系统错误 |