五度易链API开放平台的申请及接口调用

76 阅读4分钟

 

平台简介

五度易链开发者首选稳定高效的API解决方案,平台地址:api.wdsk.net/‍

安全稳定,助力数字化转型

数据多维,驱动业务增长

智能高效,提升开发效率

数据全、信息准、调用稳、响应快。 依托全域多态数据资源,构建高并发、弹性可扩展且安全合规的数据API服务,支撑全行业场景化需求。  

数据服务对接流程

服务对接流程.png 第一步,注册账号:登录五度易链API开放平台,完成用户注册;

第二步,对接客服:提供认证资料;

第三步,开通服务:联系客服可以开通接口服务,进入目标接口页面,点击“申请接口”按钮;

申请接口.png

  第四步,接入协作:联系客服开通免费试用权限,阅读参考接口文档,进行数据调用测试;

接口测试.png


调用示例:

请求http头:

名称是否必填描述示例
APPID用户appidkbQGEsHVE
SIGN验签加密值 请求APPID+请求时间戳(TIMESTAMP)+APPID对应secret+拼接STR对以上字符串进行32位 md5加签操作(小写)拼接STR: 请求json串中,按照key从小到大的顺序 获取对应value值,拼接到一起,无分隔符。04473b39f402b6dbef9a0b020fef8059
TIMESTAMP时间戳2024-04-22 15:38:23

请求业务头:

名称是否必填描述示例
key关键词(企业id/ 企业完整名称/社会统一信用代码)7Ao84AiGnVWx/山西小米产业发展有限公司/91140400MACF33Y702

返回字段说明:

名称类型层级描述
dataObject1返回列表
BASICObject2
ENTSTATUSString3经营状态
entidString3企业id
fulltitleString3完整行业代码对应中文链路名称
REGCAP_CNString3注册资本名称(GS)
UNISCIDString3统一信用代码
FRNAMEString3法人姓名
REGNOString3工商注册号
faqString3行业代码INDUSTRYCO字段的门类解释
APPRDATEString3核准日期
region_nameString3地区名
RECCAPString3实收资本
OPFROMString3经营期限开始日期
DOMString3地址
scodeString3同行业代码去掉字母
REGCAPString3注册资本
levelString3行业代码对应层级
NACAOIDString3组织机构代码
REGCAPCURString3注册资本单位币种
region_idString3地区码
ENTTYPEString3公司类型
versionString3码表库版本
ENTTYPE_idString3企业类型id
nic_nameString3行业名称
OPSCOPEString3经营范围
ESDATEString3成立日期
nameString3行业名称
ENTNAMEString3企业名称
OPTOString3经营期限结束日期(返空时表示“无固定期限” )
updatedString3数据库更新时间
INDUSTRYCOString3行业代码
REGORG_CNString3登记机关名称

错误代码

代码说明
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开放平台的申请和使用方法。希望对您有所帮助!如果有其他疑问或需求,请随时联系官方在线客服。