短链服务能将任意长链接快速转换为短链接，依靠蚂蚁多年自研的独特的网址压缩算法和不断创新，短链接生成功能强大，并支持对短链接的有效期、名称等内容的管理。支持企业独享域名。

SDK 准备

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>mpaas20201028</artifactId>
  <version>3.3.0</version>
</dependency>

创建短链

请求参数

参数名称	类型	是否必填	示例	描述
AppId	string	是	BB5953C300957	应用 ID
WorkspaceId	string	是	default	工作空间
TargetUrl	string	是	https://help.aliyun.com/document_detail/158619.html?spm\u003da2c4g.49548.0.0.74684c7aOCNi9Y	短链跳转目标地址
Domain	string	否	l.zkobjects.com	自定义域名
Cors	boolean	否	true	是否支持跨域

返回参数

参数名称	类型	示例	描述
requestId	String	2DCA4EC1-8DD9-5674-B3B1-83DF361ED49F	请求 ID
resultCode	String	100	请求结果码
resultMessage	String	success	请求结果描述
resultContent	JSON		请求结果

结果示例

{
  "requestId": "2DCA4EC1-8DD9-5674-B3B1-83DF361ED49F",
  "resultCode": "100",
  "resultContent": {
    "data": "https://l.zkobjects.com/4leDqykEXA8DPlzwSIdF7j",
    "target": "https://help.aliyun.com/document_detail/158619.html?spm\u003da2c4g.49548.0.0.74684c7aOCNi9Y",
    "version": "0"
  },
  "resultMessage": "success"
}

Java 代码示例

public static void main(String[] args) {
    Map map = new HashMap<>();
    map.put("accessKeyId", "");
    map.put("accessKeySecret", "");
    map.put("regionId", "cn-hangzhou");
    map.put("endpoint", "mpaas.cn-hangzhou.aliyuncs.com");
    CreateLinkRequest createLinkRequest = new CreateLinkRequest();
    createLinkRequest.setAppId("");
    createLinkRequest.setWorkspaceId("");
    createLinkRequest.setTargetUrl("");
    CreateLinkResponse response = null;
    Client client = null;
    try {
        Config config = Config.build(map);
        client = new Client(config);
        response = client.createLink(createLinkRequest);
        Gson gson = new Gson();
        System.out.println(gson.toJson(response.getBody()));
    } catch (Exception e) {
        e.printStackTrace();
    }
}

更新短链

请求参数

参数名称	类型	是否必填	示例	描述
AppId	string	是	BB5953C300957	应用 ID
WorkspaceId	string	是	default	工作空间
TargetUrl	string	是	https://help.aliyun.com/document_detail/158619.html?spm\u003da2c4g.49548.0.0.74684c7aOCNi9Y	短链跳转目标地址
Url	string	是	https://l.zkobjects.com/4leDqykEXA8DPlzwSIdF7j_0	短链地址
Domain	string	否	l.zkobjects.com	自定义域名
Cors	boolean	否	true	是否支持跨域

返回参数

参数名称	类型	示例	描述
requestId	String	2DCA4EC1-8DD9-5674-B3B1-83DF361ED49F	请求 ID
resultCode	String	100	请求结果码
resultMessage	String	success	请求结果描述
resultContent	JSON		请求结果

结果示例

{
    "requestId": "A5CEBA93-BC43-5135-9863-ED510E534101",
    "resultMessage": "success",
    "resultCode": "100",
    "resultContent": {
        "target": "https://help.aliyun.com/document_detail/158619.html?spm\u003da2c4g.49548.0.0.74684c7aOCNi9Y2",
        "data": "https://l.zkobjects.com/4leDqykEXA8DPlzwSIdF7j",
        "version": "1"
    }
}

Java 代码示例

public static void main(String[] args) {
    Map map = new HashMap<>();
    map.put("accessKeyId", "");
    map.put("accessKeySecret", "");
    map.put("regionId", "cn-hangzhou");
    map.put("endpoint", "mpaas.cn-hangzhou.aliyuncs.com");
    UpdateLinkRequest updateLink = new UpdateLinkRequest();
    updateLink.setAppId("");
    updateLink.setWorkspaceId("");
    updateLink.setTargetUrl("");
    updateLink.setUrl("");
    UpdateLinkResponse response = null;
    Client client = null;
    try {
        Config config = Config.build(map);
        client = new Client(config);
        response = client.updateLink(updateLink);
        Gson gson = new Gson();
        System.out.println(gson.toJson(response.getBody()));
    } catch (Exception e) {
        e.printStackTrace();
    }
}

查询短链

请求参数

参数名称	类型	是否必填	示例	描述
AppId	string	是	BB5953C300957	应用 ID
WorkspaceId	string	是	default	工作空间
Url	string	是	https://l.zkobjects.com/4leDqykEXA8DPlzwSIdF7j	短链地址

返回参数

参数名称	类型	示例	描述
requestId	String	2DCA4EC1-8DD9-5674-B3B1-83DF361ED49F	请求 ID
resultCode	String	100	请求结果码
resultMessage	String	success	请求结果描述
resultContent	JSON		请求结果
Modified	String	2024-06-12 11:00:36	更新时间
WorkspaceId	String	default	工作空间
Cors	boolean	false	是否支持跨域
Url	String	https://l.zkobjects.com/4leDqykEXA8DPlzwSIdF7j	短链地址
Target	String	https://help.aliyun.com/document_detail/158619.html?spm\u003da2c4g.49548.0.0.74684c7aOCNi9Y2	短链跳转地址
Created	String	2024-06-12 11:00:36	生成时间
Dynamictarget	String	""	动态参数
AppId	String	ONEX9F0069B092002	AppId
Version	Int	1	版本号
Traceid	String	3e0d2a2a1d741815aeee6fa688d4f1f6	Traceid，业务标识
Domain	String	l.zkobjects.com	自定义域名
Original	JSON		初次生产的短链信息

结果示例

{
    "requestId": "3207B9F8-E497-5976-AE6E-D83DAEBD103F",
    "resultCode": "100",
    "resultContent": {
        "data": {
            "Modified": "2024-06-12 11:00:36",
            "WorkspaceId": "default",
            "Cors": false,
            "Url": "https://l.zkobjects.com/4leDqykEXA8DPlzwSIdF7j",
            "Created": "2024-06-12 11:00:36",
            "LastModified": "2024-06-12 11:00:36",
            "Target": "https://help.aliyun.com/document_detail/158619.html?spm\u003da2c4g.49548.0.0.74684c7aOCNi9Y2",
            "Dynamictarget": "",
            "AppId": "ONEX9F0069B09202",
            "Version": 1,
            "Traceid": "3e0d2a2a1d741815aeee6fa688d4f1f6",
            "Domain": "l.zkobjects.com",
            "Original": {
                "Target": "https://help.aliyun.com/document_detail/158619.html?spm\u003da2c4g.49548.0.0.74684c7aOCNi9Y",
                "Dynamictarget": "",
                "Modified": "2024-05-20 16:49:26",
                "AppId": "ONEX9F0069B092002",
                "Version": 0,
                "WorkspaceId": "default",
                "Traceid": "8b926d63d04ec08285471e67a9fbc1e6",
                "Domain": "l.zkobjects.com",
                "Cors": false,
                "Created": "2024-05-20 16:49:26"
            }
        },
        "target": "https://help.aliyun.com/document_detail/158619.html?spm\u003da2c4g.49548.0.0.74684c7aOCNi9Y2",
        "version": "1"
    },
    "resultMessage": "success"
}

Java 代码示例

public static void main(String[] args) {
    Map map = new HashMap<>();
    map.put("accessKeyId", "");
    map.put("accessKeySecret", "");
    map.put("regionId", "cn-hangzhou");
    map.put("endpoint", "mpaas.cn-hangzhou.aliyuncs.com");
   QueryLinkRequest queryLinkRequest = new QueryLinkRequest();
    queryLinkRequest.setAppId("");
    queryLinkRequest.setWorkspaceId("");
    queryLinkRequest.setUrl("");
    QueryLinkResponse response = null;
    Client client = null;
    try {
        Config config = Config.build(map);
        client = new Client(config);
        response = client.queryLink(queryLinkRequest);
        Gson gson = new Gson();
        System.out.println(gson.toJson(response.getBody()));
    } catch (Exception e) {
        e.printStackTrace();
    }
}