平台简介
五度易链开发者首选稳定高效的API解决方案,平台地址:api.wdsk.net/
安全稳定,助力数字化转型
数据多维,驱动业务增长
智能高效,提升开发效率
数据全、信息准、调用稳、响应快。 依托全域多态数据资源,构建高并发、弹性可扩展且安全合规的数据API服务,支撑全行业场景化需求。
数据服务对接流程
第一步,注册账号:登录五度易链API开放平台,完成用户注册;
第二步,对接客服:提供认证资料;
第三步,开通服务:联系客服可以开通接口服务,进入目标接口页面,点击“申请接口”按钮;
第四步,接入协作:联系客服开通免费试用权限,阅读参考接口文档,进行数据调用测试;
调用示例:
请求http头:
| 名称 | 是否必填 | 描述 | 示例 |
|---|---|---|---|
| APPID | 是 | 用户appid | kbQGEsHVE |
| SIGN | 是 | 验签加密值 请求APPID+请求时间戳(TIMESTAMP)+APPID对应secret+拼接STR对以上字符串进行32位 md5加签操作(小写)拼接STR: 请求json串中,按照key从小到大的顺序 获取对应value值,拼接到一起,无分隔符。 | 04473b39f402b6dbef9a0b020fef8059 |
| TIMESTAMP | 是 | 时间戳 | 2024-04-22 15:38:23 |
请求业务头:
| 名称 | 是否必填 | 描述 | 示例 |
|---|---|---|---|
| key | 是 | 关键词(企业id/ 企业完整名称/社会统一信用代码) | 7Ao84AiGnVWx/山西小米产业发展有限公司/91140400MACF33Y702 |
返回字段说明:
| 名称 | 类型 | 层级 | 描述 |
|---|---|---|---|
| data | Object | 1 | 返回列表 |
| BASIC | Object | 2 | |
| ENTSTATUS | String | 3 | 经营状态 |
| entid | String | 3 | 企业id |
| fulltitle | String | 3 | 完整行业代码对应中文链路名称 |
| REGCAP_CN | String | 3 | 注册资本名称(GS) |
| UNISCID | String | 3 | 统一信用代码 |
| FRNAME | String | 3 | 法人姓名 |
| REGNO | String | 3 | 工商注册号 |
| faq | String | 3 | 行业代码INDUSTRYCO字段的门类解释 |
| APPRDATE | String | 3 | 核准日期 |
| region_name | String | 3 | 地区名 |
| RECCAP | String | 3 | 实收资本 |
| OPFROM | String | 3 | 经营期限开始日期 |
| DOM | String | 3 | 地址 |
| scode | String | 3 | 同行业代码去掉字母 |
| REGCAP | String | 3 | 注册资本 |
| level | String | 3 | 行业代码对应层级 |
| NACAOID | String | 3 | 组织机构代码 |
| REGCAPCUR | String | 3 | 注册资本单位币种 |
| region_id | String | 3 | 地区码 |
| ENTTYPE | String | 3 | 公司类型 |
| version | String | 3 | 码表库版本 |
| ENTTYPE_id | String | 3 | 企业类型id |
| nic_name | String | 3 | 行业名称 |
| OPSCOPE | String | 3 | 经营范围 |
| ESDATE | String | 3 | 成立日期 |
| name | String | 3 | 行业名称 |
| ENTNAME | String | 3 | 企业名称 |
| OPTO | String | 3 | 经营期限结束日期(返空时表示“无固定期限” ) |
| updated | String | 3 | 数据库更新时间 |
| INDUSTRYCO | String | 3 | 行业代码 |
| REGORG_CN | String | 3 | 登记机关名称 |
错误代码
| 代码 | 说明 |
|---|---|
| 200 | 交易成功 |
| 401 | 网关验证失败 |
| 404 | 客户端请求的资源不存在,例如输入了错误的URL。 |
| 403 | 服务器收到请求,但是拒绝提供服务,可能是因为客户端未经过身份认证或授权。 |
| 500 | 服务器遇到意外情况,无法完成请求。 |
| 503 | 服务器当前不能处理客户端的请求,一段时间后可能恢复正常。 |
示例代码
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Map;
import java.util.Objects;
import java.util.TreeMap;
import okhttp3.*;
public class Main {
private static final String APP_ID = "your_app_id";
private static final String SECRET = "your_secret";
public static void main(String[] args) {
String url = "http://ceshi.qyxqk.com:9202/wdyl/openapi/xxxxxx/";
String requestBody = "{\"key\":\"小米\"}";
try {
// 计算 SIGN 签名
String timestamp = generateTimestamp();
String sign = calculateSign(APP_ID, timestamp, SECRET, requestBody);
// 构建 HTTP 请求
OkHttpClient client = new OkHttpClient();
RequestBody body = RequestBody.create(MediaType.parse("application/json"), requestBody);
Request request = new Request.Builder()
.url(url)
.addHeader("APPID", APP_ID)
.addHeader("TIMESTAMP", timestamp)
.addHeader("SIGN", sign)
.post(body)
.build();
// 发送请求并获取响应
Response response = client.newCall(request).execute();
String responseBody = Objects.requireNonNull(response.body()).string();
System.out.println("Response: " + responseBody);
} catch (IOException | NoSuchAlgorithmException e) {
e.printStackTrace();
}
}
private static String generateTimestamp() {
SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
return dateFormat.format(new Date());
}
private static String calculateSign(String appId, String timestamp, String secret, String requestBody)
throws NoSuchAlgorithmException {
// 构建拼接STR
TreeMap<String, String> paramMap = new TreeMap<>();
paramMap.put("key", "小米");
StringBuilder sb = new StringBuilder();
for (Map.Entry<String, String> entry : paramMap.entrySet()) {
sb.append(entry.getValue());
}
String concatStr = sb.toString();
// 计算签名
String signString = appId + timestamp + secret + concatStr;
MessageDigest md = MessageDigest.getInstance("MD5");
byte[] digest = md.digest(signString.getBytes());
StringBuilder signBuilder = new StringBuilder();
for (byte b : digest) {
signBuilder.append(String.format("%02x", b));
}
return signBuilder.toString();
}
}
定价与计费
按次计费,根据API实际调用次数实时结算,这种计费方式适用于业务波动较大的场景,且该方式具有成本可控性和资源弹性优势。
包年计费,采用订阅年费模式调用API,这种服务模式适用于持续高频需求场景,且该方式可以降低总体成本并免除对账负担。
安全建议
避免泄露您的appid和Secretkey,定期更换API密钥,防止泄露秘钥,以确保其安全。
请确保您的网络环境安全,防止被恶意截取。
以上内容就是五度易链API开放平台的申请和使用方法。希望对您有所帮助!如果有其他疑问或需求,请随时联系官方在线客服。