调用抖音API接口，分享视频

提示：抖音的接口，需要client_key、client_secret等信息，若想调用需要申请。

1. 需求及背景介绍

        最近，在做一个后台服务，该服务需要给车机端app提供一系列功能，比如，获得用户抖音账号的授权、视频的自动分享、token自动续期等。所有的功能中，我主要讲一下在视频上传时的一些过程（需要先拿到授权）。如下图所示，将视频上传到用户的抖音账号，对于单个视频，分两步：①上传视频；②创建视频。

        从视频上传的相关参数要求可以看出，这是一个表单提交请求，url中携带2个参数，表单的请求体是上传视频的字节数组，且请求体也需要添加 Content-Disposition 和 Content-Type 属性。

        分析完了抖音接口的相关功能后，剩下的就是敲代码了。这是一个后台服务，要操作的视频是存储在阿里的OSS中，我需要通过流的方式将OSS中的视频，直接上传到抖音服务器。这是一个SpringBoot项目，我计划通过RestTemplate来调用都有的API接口。

2. 任务一：单个文件上传至抖音

2.1 构建uri

按照接口规则，需要在url中传递open_id和access_token，为了方便扩展，我写了一个工具类：

public abstract class DouYinUriUtil {
    private static final Logger LOGGER = LoggerFactory.getLogger(DouYinUriUtil.class);
    private static final String BASE_URL = "https://open.douyin.com/";
    public static final String VIDEO_UPLOAD_URL = BASE_URL + "video/upload/";

    public static URI forUpload(String openId, String accessToken) {
        MultiValueMap params = paramsToMap(openId, accessToken);
        return UriComponentsBuilder.fromHttpUrl(VIDEO_UPLOAD_URL)
                .queryParams(params)
                .build()
                .toUri();
    }

    private static MultiValueMap paramsToMap(String openId, String accessToken) {
        Assert.notNull(openId, "必须提供openId");
        Assert.notNull(accessToken, "必须提供accessToken");

        MultiValueMap params = new LinkedMultiValueMap<>();
        params.add("open_id", openId);
        params.add("access_token", accessToken);
        return params;
    }

    public static URI forPartUploadSecondStep(String openId, String accessToken, String uploadId, long partNumber) {
        MultiValueMap params = openIdAndAccessTokenToMap(openId, accessToken);
        Assert.notNull(uploadId, "必须提供uploadId");
        try {
            // 抖音要求：upload_id作为url参数时，必须encode，只对upload_id进行encode
            String encodedUploadId = URLEncoder.encode(uploadId, "utf-8");

            params.add("upload_id", encodedUploadId);
            params.add("part_number", String.valueOf(partNumber));

            String encodedUri = UriComponentsBuilder.fromHttpUrl(VIDEO_PART_UPLOAD_URL)
                    .queryParams(params)
                    .build()
                    .toString();
            return new URI(encodedUri);
        } catch (UnsupportedEncodingException | URISyntaxException e) {
            LOGGER.info("对 uploadId {} 进行编码是出错：{}", uploadId, e.getMessage());
            throw new RuntimeException(e);
        }
    }

    private static MultiValueMap openIdAndAccessTokenToMap(String openId, String accessToken) {
        Assert.notNull(openId, "必须提供openId");
        Assert.notNull(accessToken, "必须提供accessToken");

        MultiValueMap params = new LinkedMultiValueMap<>();
        params.add("open_id", openId);
        params.add("access_token", accessToken);
        return params;
    }
}

2.2 构建请求头、请求体，及上传

        在构建请求体的时候，踩了一个坑，抖音官方文档要求，必须在请求体的请求头中有Content-Type这个参数，没有强调Content-Disposition的要求，由于技术能力有限，对表单提交的相关参数不是很熟悉，所以没有重视Content-Disposition参数的，当时接口迟迟调不通，后来反复实验，发现Content-Type这个参数实际是可有可无的，反而是Content-Disposition这个参数，必须包含name和filaname字段，且name字段的值必须为video。（这块不要喷我，当时确实对表单提交的请求体的参数要求不是很了解，后来恶补了一下http相关的知识，才发现这个就是表单实现文件上传的标准格式）

private ResponseEntity uploadWithInputStream(String openId, String accessToken, String fileName, InputStream inputStream) {
    // 构建请求头
    URI uri = DouYinUriUtil.forUpload(openId, accessToken);
    RequestEntity.BodyBuilder builder = RequestEntity.method(HttpMethod.POST, uri);
    builder.accept(MediaType.APPLICATION_JSON);
    builder.contentType(MediaType.MULTIPART_FORM_DATA);
    builder.header("User-Agent", "Java-SDK");

    // 构建请求体
    final MultiValueMap formParams = new LinkedMultiValueMap<>();
    Resource resource = new InputStreamResource(inputStream);
    MultiValueMap header = new LinkedMultiValueMap<>();
    header.put("Content-Disposition", Collections.singletonList("form-data; name=\"video\"; filename=\"" + fileName + "\""));
    header.put("Content-Type", Collections.singletonList("video/mp4"));
    HttpEntity