# 实施步骤 #### API调用示例（1116-企业基本信息） 客户在购买API后，可选择所购买的API接口进行相关调校工作。具体接口信息可在网址： 获取 图1获取信息 ![](https://support.huaweicloud.com/tbis-dma/zh-cn_image_0000001862467668.png) 因为天眼查商业查询的216个接口，对接操作方式相同，因此下面以API"1116-企业基本信息"为例，做使用调测说明。 #### 获取API基本信息 基本信息： 图2基本信息 ![](https://support.huaweicloud.com/tbis-dma/zh-cn_image_0000001862627504.png) **是否需要授权** 是，需要添加请求header ``` HttpGet get = new HttpGet(url); get.setHeader("Authorization", token); ``` #### 根据代码示例修改获取方式 ``` /** * @param path 对⽅或第三⽅提供的路径 * @param token * @return */ public static String getMessageByUrlToken(String path,String token){ String result=""; try { // 根据地址获取请求 HttpGet request = new HttpGet(path);//这⾥发送get请求 // 获取当前客户端对象 request.setHeader("Authorization", token); HttpClient httpClient = new DefaultHttpClient(); // 通过请求对象获取响应对象 HttpResponse response = httpClient.execute(request); // 判断网络连接状态码是否正常(0--200都数正常) if (response.getStatusLine().getStatusCode() == HttpStatus.SC_OK) { result= EntityUtils.toString(response.getEntity(),"utf-8"); } } catch (Exception e) { // TODO Auto-generated catch block e.printStackTrace(); e.printStackTrace(); } return result; } // 访问授权限制访问级别：普通接⼝ ``` #### 请求参数 表1请求参数 | 参数 | 必选 | 类型及范围 | 说明 | |:---|:---|:---|:---| | keyword | true | String | 搜索关键字（公司名称~、~公司id、注册号或社会统⼀信⽤代码） | ![](https://support.huaweicloud.com/tbis-dma/public_sys-resources/note_3.0-zh-cn.png) 请求参数需要URLEncode。 #### 返回结果校验 JSON示例 ``` { “result”: { "historyNames" : “贵州力源液压股份有限公司；”, "cancelDate" null, "regStatus" : “存续”, "regCapital" : “77800.32万人民币”, "city" : “毕节市”, "staffNumRange" : “5000-9999人”, "bondNum" : “600765”, "historyNameList" : [“贵州力源液压股份有限公司”], "industry" : “汽车制造业”, "bondName" : “中航重机”, "revokeDate" : null, "type" : 1, "updateTimes" : 1620622963000, "legalPersonName" : “姬苏春”, "revokeReason" : “”, "regNumber" : “520000000005018”, "creditCode" : “91520000214434146R”, "property3" : “AVIC Heavy Machinery Co.,Ltd.”, "usedBondName" : “力源液压->G力源->力源液压”, "approvedTime" : 1582646400000, "fromTime" : 847900800000, "socialStaffNum" : 9023, "actualCapitalCurrency" : “人民币”, "alias" : “中航重机”, "company0rgType" : “其他股份有限公司（上市）”, "id" : 11684584, "cancelReason" : “”, "orgNumber" : “214434146”, "toTime" : null, "actualCapital" : “77800.32万人民币”, "estiblishTime" : 847900800000, "regInstitute" : “贵阳市市场监督管理局贵州双龙航空港经济区分局”, "businessScope" : “法律、法规、国务院决定规定禁止的不得经营；”, "taxNumber" : “91520000214434146R”, "regCapitalCurrency" : “人民币”, "tags" : “企业集团；存续；融资轮次；上市信息；项目品牌；投资机构；曾用名”, "district" : “威宁彝族回族苗族自治县”, "bondType" : “A股”, "name" : “中航重机股份有限公司”, "percentileScore" : 9696, "industryAll" : { "categoryMiddle" : “改装汽车制造”, "categoryBig" : “汽车制造”, "category" : “制造业”, "categorySmall" : “” }， "isMicroEnt" : 0, "base" : “gz”, }， “reason”: “ok”, “reason”: 0 } ``` 关于错误返回值与错误代码，参⻅错误代码说明 #### 返回字段说明 根据返回字段进行调校。 表2返回字段说明 | 返回值字段 | 字段类型 | 字段说明 | 备注 | |:---|:---|:---|:---| | result | Object | - | - | | historyNames | String | varchar(255) | 曾⽤名 | | regStatus | String | varchar(31) | 企业状态 | | cancelDate | Number | 时间戳 | 注销⽇期 | | regCapital | String | varchar(50) | 注册资本 | | city | String | varchar(20) | 市 | | staffNumRange | String | varchar(200) | ⼈员规模 | | industry | String | varchar(255) | ⾏业 | | historyNameList | Array | - | 曾⽤名 | | bondNum | String | varchar(20) | 股票号 | | type | Number | int(1) | 法⼈类型，1 ⼈ 2 公司 | | bondName | String | varchar(20) | 股票名 | | updateTimes | Number | 时间戳 | 更新时间 | | revokeDate | Number | 时间戳 | 吊销⽇期 | | legalPersonName | String | varchar(255) | 法⼈ | | revokeReason | String | varchar(500) | 吊销原因 | | regNumber | String | varchar(31) | 注册号 | | property3 | String | varchar(255) | 英⽂名 | | creditCode | String | varchar(255) | 统⼀社会信⽤代码 | | usedBondName | String | varchar(20) | 股票曾⽤名 | | fromTime | Number | 时间戳 | 经营开始时间 | | approvedTime | Number | 时间戳 | 核准时间 | | socialStaffNum | Number | int(10) | 参保⼈数 | | alias | String | varchar(255) | 简称 | | companyOrgType | String | varchar(127) | 企业类型 | | actualCapitalCurrency | String | varchar(10) | 实收注册资本币种 ⼈⺠币 美元 欧元 等 | | id | Number | int(20) | 企业id | | orgNumber | String | varchar(31) | 组织机构代码 | | cancelReason | String | varchar(500) | 注销原因 | | toTime | Number | 时间戳 | 经营结束时间 | | actualCapital | String | varchar(50) | 实收注册资⾦ | | estiblishTime | Number | 时间戳 | 成⽴⽇期 | | regInstitute | String | varchar(255) | 登记机关 | | taxNumber | String | varchar(255) | 纳税⼈识别号 | | businessScope | String | varchar(4091) | 经营范围 | | regLocation | String | varchar(255) | 注册地址 | | regCapitalCurrency | String | varchar(10) | 注册资本币种 ⼈⺠币 美元 欧元 等 | | tags | String | varchar(255) | 企业标签 | | district | String | varchar(20) | 区 | | name | String | varchar(255) | 企业名 | | bondType | String | varchar(31) | 股票类型 | | percentileScore | Number | 万分制 | 企业评分 | | industryAll | Object | - | 国⺠经济⾏业分类 | | categoryMiddle | String | varchar(255) | 国⺠经济⾏业分类中类 | | categoryBig | String | varchar(255) | 国⺠经济⾏业分类⼤类 | | category | String | varchar(255) | 国⺠经济⾏业分类⻔类 | | categorySmall | String | varchar(255) | 国⺠经济⾏业分类⼩类 | | isMicroEnt | Number | int(1) | 是否是⼩微企业 0不是 1是 | | base | String | varchar(31) | 省份简称 | | reason | String | - | 错误信息 | | error_code | Number | - | 状态码 | #### 错误代码说明 表3错误代码说明 | 代码 | 说明 | |:---|:---| | 0 | 请求成功 | | 300000 | ⽆数据 | | 300001 | 请求失败 | | 300002 | 账号失效 | | 300003 | 账号过期 | | 300004 | 访问频率过快 | | 300005 | ⽆权限访问此api | | 300006 | 余额不⾜ | | 300007 | 剩余次数不⾜ | | 300008 | 缺少必要参数 | | 300009 | 账号信息有误 | | 300010 | URL不存在 | | 300011 | 此IP⽆权限访问此api | | 300012 | 报告⽣成中 |