通过OSS上传文件-阿里云帮助中心

在使用API申请签名/模板时，需要上传证明材料、资质证件。请您根据本文方法将相关材料上传至OSS后，在API中提交文件路径参数。资料完善有助于审核人员了解您的业务详情，提高审核效率；如未按规范提交或不提交，可能会影响您的审核流程。

步骤一：获取OSS配置信息

申请签名/模板时，上传证明材料：通过GetOSSInfoForUploadFile接口获取OSS配置信息，入参请传fcMediaSms。

返回示例：

{
  "RequestId": "A90E4451-FED7-49D2-87C8-00700EDCFD0D",
  "Message": "OK",
  "Model": {
    "Policy": "eyJleHBpcmF0aW9uIjoiMjAyN*************************************9udGVudC1sZW5ndGgtcmFuZ2UiLDAsMTA0ODU3NjAwMF0sWyJzdGFydHMtd2l0***sIiRrZXkiLCIiXV19",
    "StartPath": "123456",
    "AccessKeyId": "LTAI****************",
    "Signature": "BXnwCWPrhVb*****aoZHZfli5KE=",
    "Host": "https://alicom-fc-media.oss-cn-zhangjiakou.aliyuncs.com",
    "ExpireTime": "1719297445"
  },
  "Code": "OK",
  "Success": true
}

步骤二：上传文件

获取OSS配置后，可上传文件到指定OSS。若多个资料可拼接成一个文件，支持png、jpg、jpeg、doc、docx、pdf格式。

文件资料规范：资质材料 | 授权书规范 | 签名申请材料 | 模板规范 | 用户授权证明材料

本文给出Java服务端上传示例代码，更多详情请参见PostObject。

import org.apache.commons.io.FilenameUtils;
import org.apache.commons.lang3.StringUtils;
import org.apache.http.HttpEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.util.EntityUtils;

import java.io.File;
import java.io.IOException;
import java.nio.charset.StandardCharsets;


public class HttpOssClient {

    // 对应返回值中的 Signature
    private String signature = "BXnwCW**********aoZHZfli5KE=";
    // 对应返回值中的 Policy
    private String policy = "eyJleHBpcmF0aW9uIjoiMjAyN******************************************9udGVudC1sZW5ndGgtcmFuZ2UiLDAsMTA0ODU3NjAwMF0sWyJzdGFydHMtd2l0***sIiRrZXkiLCIiXV19";
    // 您要上传的本地文件路径
    private String localFilePath = "<PATH_TO_YOUR_FILE>";
    // 对应返回值中的 AccessKeyId
    private String accessKeyId = "LTAI****************";
    // 对应返回值中的 StartPath，注意以 / 结尾
    private String startPath = "123456" + "/";
    // 对应返回值中的 Host
    private String url = "https://alicom-fc-media.oss-cn-zhangjiakou.aliyuncs.com";


    public static void main(String[] args) throws Exception {
        new HttpOssClient().upload();
    }

    private String getFileName() {
        String fileName = localFilePath;
        if(localFilePath.contains(File.separator)){
            fileName = FilenameUtils.getName(localFilePath);
        }
        String extension = FilenameUtils.getExtension(fileName);
        String prefFileName = StringUtils.substringBefore(fileName,".");
        // 文件名进行编码
        String encodeFileName = new String(prefFileName.getBytes(),StandardCharsets.UTF_8);
        // 加一个时间戳，防止文件重名覆盖
        fileName = encodeFileName + System.currentTimeMillis() + FilenameUtils.EXTENSION_SEPARATOR + extension ;

        return fileName;
    }

    private void upload() throws Exception {
        CloseableHttpClient httpClient = HttpClientBuilder.create().build();
        CloseableHttpResponse httpResponse = null;
        HttpPost httpPost = new HttpPost(url);

        ContentType contentType = ContentType.create("text/plain",StandardCharsets.UTF_8);

        String fileName = getFileName();
        String fileKey = this.startPath + fileName;
        File file = new File(localFilePath);

        HttpEntity requestHttpEntity = MultipartEntityBuilder.create()
                .addTextBody("OSSAccessKeyId", this.accessKeyId)
                .addTextBody("Signature", this.signature)
                .addTextBody("policy", this.policy)
                .setContentType(ContentType.MULTIPART_FORM_DATA)
                .addTextBody("key", fileKey,contentType)
                .addBinaryBody("file", file)
                .setCharset(StandardCharsets.UTF_8)
                .build();

        httpPost.setEntity(requestHttpEntity);

        httpPost.setHeader("User-Agent",
                "Mozilla/5.0 (Windows; U; Windows NT 6.1; zh-CN; rv:1.9.2.6)");
        httpPost.setHeader("Accept", "*/*");


        httpResponse = httpClient.execute(httpPost);
        HttpEntity entity = httpResponse.getEntity();
        int statusCode = httpResponse.getStatusLine().getStatusCode();
        System.out.println("http status  " + statusCode);

        if (null != entity) {
            String str = EntityUtils.toString(entity);
            System.out.println("http res:  " + str);
        }
        EntityUtils.consume(entity);
        httpClient.close();
        if (httpResponse != null) {
            httpResponse.close();
        }
        if (statusCode >= 200 && statusCode < 300) {
            System.out.println("fileKey : " + fileKey);
        } else {
            throw new IOException("Server returned HTTP response code: " + statusCode + " for URL: " + this.url.toString());
        }
    }

}

说明

请您对文件名进行处理（添加时间戳），避免提交导致文件覆盖，参见示例代码中getFileName。

步骤三：提交文件路径参数

文件上传成功后，使用示例代码中的返回的fileKey进行提交。

申请签名/模板时，上传证明材料：将fileKey设置为CreateSmsSign、CreateSmsTemplate接口中的MoreData参数值。

填写示例："123456/test1719383196031.jpg"