Bitly使用指南

Bitly使用指南

1.概述

Bitly是世界上最广泛信任的链接管理平台。通过使用Bitly API，您将通过自动链接定制、移动深度链接和点击分析来充分发挥链接的功能。此文档主要讲述把长链接通过Bitly API转换成短链接，可通过访问生成的短链接直接访问原访问地址。主要分三步

2.准备

在此之前你需要到官网https://app.bitly.com/，注册账号（若已有账号，可跳过），

之后你会在邮箱收到一封验证邮件

然后回到登录页面登录即可

最后去获得一个token

3.生成短链

生成短链一共分为三步，最终的Util工具包和resp接收响应对象都放在文档最后

第一步，获取guid

https://dev.bitly.com/api-reference/#getGroups

public static String getGroupId() {
    String resp = HttpRequest.get(groupsUrl).
    //若jdk版本为1.7需要指定协议为1.2，jdk1.7默认为1.1，jdk1.8默认为1.2
    setSSLProtocol("TLSv1.2").
    header("Authorization", "Bearer " + BitlyConfig.accessToken).
    execute().
    body();
    logger.info("BitlyUtil_getGroupId_resp:{}", resp);

    BitlyGroupResp bitlyGroupResp = JSON.parseObject(resp, BitlyGroupResp.class);
    if (ObjectUtil.isNotNull(bitlyGroupResp)) {
        return bitlyGroupResp.getGroups().get(0).getGuid();
    }

    return null;
}

第二步，生成短链接

https://dev.bitly.com/api-reference/#createBitlink

Map<String, Object> params = new HashMap<>(3);
params.put("long_url", longUrl);
params.put("group_guid", groupId);
params.put("domain", domain);

String shortenResp = HttpRequest.post(shortenUrl).
        //若jdk版本为1.7需要指定协议为1.2，jdk1.7默认为1.1，jdk1.8默认为1.2
        setSSLProtocol("TLSv1.2").
        header("Authorization", "Bearer " + BitlyConfig.accessToken).
        header("Content-Type", "application/json").
        body(JSON.toJSONString(params)).
        execute().body();
logger.info("BitlyUtil_geBitlyShorten_resp:{}", resp);
BitlyShortenResp bitlyShortenResp = JSON.parseObject(shortenResp, BitlyShortenResp.class);

return bitlyShortenResp.getId();

第三步，自定义短链接

https://dev.bitly.com/api-reference/#addCustomBitlink

params.put("custom_bitlink", extend);
params.put("bitlink_id", bitlyShortenResp.getId());

String resp = HttpRequest.post(customBitlinksUrl).
        //若jdk版本为1.7需要指定协议为1.2，jdk1.7默认为1.1，jdk1.8默认为1.2
        setSSLProtocol("TLSv1.2").
        header("Authorization", "Bearer " + BitlyConfig.accessToken).
        header("Content-Type", "application/json").
        body(JSON.toJSONString(params)).
        execute().body();
logger.info("BitlyUtil_geBitlyShorten_customerResp:{}", resp);
CustomBitlinksResp customBitlinksResp = JSON.parseObject(resp, CustomBitlinksResp.class);

return customBitlinksResp.getCustom_bitlink();

4.工具类

import cn.hutool.core.util.ObjectUtil;
import cn.hutool.http.HttpRequest;
import com.alibaba.fastjson.JSON;
import com.bk.llh.demo02.config.BitlyConfig;
import com.bk.llh.demo02.core.resp.BitlyGroupResp;
import com.bk.llh.demo02.core.resp.BitlyShortenResp;
import com.bk.llh.demo02.core.resp.CustomBitlinksResp;

import java.util.HashMap;
import java.util.Map;

/**
 * @author liulihao
 */
public class BitlyUtil {
    public static String groupsUrl = BitlyConfig.domain + "groups";
    public static String shortenUrl = BitlyConfig.domain + "shorten";
    public static String customBitlinksUrl = BitlyConfig.domain + "custom_bitlinks";

    /**
     * 1.getGroupId
     *
     * @return
     */
    public static String getGroupId() {
        String resp = HttpRequest.get(groupsUrl).
                //若jdk版本为1.7需要指定协议为1.2，jdk1.7默认为1.1，jdk1.8默认为1.2
                //setSSLProtocol("TLSv1.2").
                header("Authorization", "Bearer " + BitlyConfig.accessToken).
                execute().body();

        BitlyGroupResp bitlyGroupResp = JSON.parseObject(resp, BitlyGroupResp.class);
        if (ObjectUtil.isNotNull(bitlyGroupResp)) {
            return bitlyGroupResp.getGroups().get(0).getGuid();
        }

        return null;
    }

    /**
     * 2.getBitlyShorten
     *
     * @param longUrl 需要转短链的长链
     * @param domain
     * @param extend 自定义短链
     * @return
     */
    public static String getBitlyShorten(String longUrl, String domain, String extend) {
        //1.获取groupId
        String groupId = getGroupId();

        //2.生成短链接
        Map<String, Object> params = new HashMap<>(3);
        params.put("long_url", longUrl);
        params.put("group_guid", groupId);
        params.put("domain", domain);

        String shortenResp = HttpRequest.post(shortenUrl).
                //若jdk版本为1.7需要指定协议为1.2，jdk1.7默认为1.1，jdk1.8默认为1.2
                //setSSLProtocol("TLSv1.2").
                header("Authorization", "Bearer " + BitlyConfig.accessToken).
                header("Content-Type", "application/json").
                body(JSON.toJSONString(params)).
                execute().body();
        BitlyShortenResp bitlyShortenResp = JSON.parseObject(shortenResp, BitlyShortenResp.class);


        //3.自定义短链
        params.put("custom_bitlink", extend);
        params.put("bitlink_id", bitlyShortenResp.getId());

        String resp = HttpRequest.post(customBitlinksUrl).
                //若jdk版本为1.7需要指定协议为1.2，jdk1.7默认为1.1，jdk1.8默认为1.2
                //setSSLProtocol("TLSv1.2").
                header("Authorization", "Bearer " + BitlyConfig.accessToken).
                header("Content-Type", "application/json").
                body(JSON.toJSONString(params)).
                execute().body();
        CustomBitlinksResp customBitlinksResp = JSON.parseObject(resp, CustomBitlinksResp.class);

        return customBitlinksResp.getCustom_bitlink();
    }
}

5.接收响应对象

BitlyGroupResp

import java.util.List;

/**
 * @author liulihao
 */

public class BitlyGroupResp {
    private List<GroupsBean> groups;

    public static class GroupsBean {
        private String guid;

        public String getGuid() {
            return guid;
        }

        public void setGuid(String guid) {
            this.guid = guid;
        }
    }

    public List<GroupsBean> getGroups() {
        return groups;
    }

    public void setGroups(List<GroupsBean> groups) {
        this.groups = groups;
    }
}

BitlyShortenResp

public class BitlyShortenResp {
    private String id;
    private String link;

    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }

    public String getLink() {
        return link;
    }

    public void setLink(String link) {
        this.link = link;
    }
}

CustomBitlinksResp

public class CustomBitlinksResp {

    private String custom_bitlink;

    public String getCustom_bitlink() {
        return custom_bitlink;
    }

    public void setCustom_bitlink(String custom_bitlink) {
        this.custom_bitlink = custom_bitlink;
    }
}

6.配置类

import org.springframework.stereotype.Component;

/**
 * @author liulihao
 * @since 2022/9/13 9:35
 */
@Component
public class BitlyConfig {
    /**
     * api前缀
     */
    public static final String domain = "https://api-ssl.bitly.com/v4/";
    /**
     * 配置成自己的token
     */
    public static final String accessToken = "abcdefghijklmnpqrstuvwxyz123456789";
}