接入说明

    1. 通过WeBASE管理平台获得注册信息,并通过API向WeBASE注册服务。
    2. 通过WeBASE提供的基础能力API和WeBASE连通。

    WeBASE-APP-SDK是应用集成SDK,提供调用WeBASE-Node-Manager的接口,方便WeBASE管理台接入第三方应用。 ​ 从开始,提供应用集成SDK,方便应用接入。接口API可以查看WeBASE通用API。调用之前需要添加依赖和初始化应用信息。

    • v1.5.1及其以上版本,应用配置AppConfig的属性isTransferEncrypt需和WeBASE-Node-Manager的配置文件/conf/application.yml下的配置constant.isTransferEncrypt相同,默认为true
    • 如果v1.5.0需要使用SDK,应用配置AppConfig的属性isTransferEncrypt需设置为falsev1.5.1及其以上版本新增的接口调用不了。

    添加依赖

    • 添加 SDK 的依赖,以Gradle为例
    • 应用配置
    1. public class AppConfig {
    2. // 节点管理服务地址
    3. private String nodeManagerUrl;
    4. // 应用Key
    5. private String appKey;
    6. // 应用密码
    7. private String appSecret;
    8. private boolean isTransferEncrypt;
    9. }
    • Http请求配置

    调用示例

    1. public class ClientTest {
    2. // WeBASE-Node-Manager的url
    3. private static String url = "http://localhost:5001";
    4. private static String appSecret = "65KiXNxUpPywVwQxM7SFsMHsKmCbpGrQ";
    5. private static boolean isTransferEncrypt = true;
    6. private static AppClient appClient = null;
    7. public static void main(String[] args) {
    8. try {
    9. initClient();
    10. appRegister();
    11. } catch (Exception e) {
    12. e.printStackTrace();
    13. }
    14. System.exit(0);
    15. }
    16. public static void initClient() {
    17. // 未设置httpConfig时,默认http连接均为30s
    18. HttpConfig httpConfig = new HttpConfig(30, 30, 30);
    19. appClient = new AppClient(url, appKey, appSecret, isTransferEncrypt, httpConfig);
    20. System.out.println("testInitClient:" + JacksonUtil.objToString(appClient));
    21. }
    22. public static void appRegister() throws Exception {
    23. ReqAppRegister req = new ReqAppRegister();
    24. req.setAppIp("127.0.0.1");
    25. req.setAppPort(5001);
    26. req.setAppLink("https://127.0.0.1:5001/");
    27. appClient.appRegister(req);
    28. System.out.println("appRegister end.");
    29. } catch (Exception e) {
    30. e.printStackTrace();
    31. }
    32. }
    33. }

    签名

    使用SDK时,SDK会自动填充。

    • 每个URL请求需带以下三个参数:

    签名规则

    使用MD5对timestampappKey加密并转大写得到签名值signature

    • 参数值:
    参数参数值
    timestamp1614928857832
    appKeyfdsf78aW
    appSecretoMdarsqFOsSKThhvXagTpNdoOcIJxUwQ