首页 帮助中心 API

彩信附件上传

说明: 上传彩信附件。

请求参数说明:

参数 说明 是否必填 类型

fileType

彩信附件类型,支持: [png,jpg,jpeg,bmp,gif,webp,psd,svg,tiff,mp3,wav,txt,vcf]

String

fileData

彩信文件base64加密传输。彩信的发送附件大小上限是50kb,单个任务最多携带3份彩信文件(base64编码转换可查看该方法最下方JAVA示例代码)

String

请求URL:

                      
                        https://api.onbuka.com/v3/mmsUpload
                      
                    

请求示例上传附件内容为“123456”的txt附件:

                                                
                                                    Request URL:
                                                        https://api.onbuka.com/v3/mmsUpload
                                                    Request Method:
                                                        POST
                                                    Request Headers:
                                                        Content-Type: application/json;charset=UTF-8
                                                        Sign: 05d7a50893e22a5c4bb3216ae3396c7c
                                                        Timestamp: 1630468800
                                                        Api-Key: bDqJFiq9
                                                    Request Body:
                                                    {
                                                        "fileType":"txt",
                                                        "fileData":"MTIzNDU2"
                                                    }
                                                

                    

请求示例上传png附件:

                                                
                                                    Request URL:
                                                        https://api.onbuka.com/v3/mmsUpload
                                                    Request Method:
                                                        POST
                                                    Request Headers:
                                                        Content-Type: application/json;charset=UTF-8
                                                        Sign: 05d7a50893e22a5c4bb3216ae3396c7c
                                                        Timestamp: 1630468800
                                                        Api-Key: bDqJFiq9
                                                    Request Body:
                                                    {
                                                        "fileType":"png",
                                                        "fileData":"Base64 encoded file content"
                                                    }
                                                

                    

响应参数说明:

参数 说明 类型

status

状态码,0成功,其他失败参见状态码说明

String

reason

失败原因说明

String

data

上传附件id,有效期3天,3天内可用于重复发送彩信

String

响应示例:

                                                
                                                    {
                                                        "status":"0",
                                                        "reason":"success",
                                                        "data":"57_3_1727059993381.txt"
                                                    }
                                                

                  

Java-base64编码转换示例代码:

                                                    
                                                      package com;
                                                      import cn.hutool.core.codec.Base64;
                                                      import java.io.File;
                                                      import java.io.FileInputStream;
                                                      import java.io.FileNotFoundException;
                                                      import java.io.IOException;
                                                      
                                                      public class fileUpload {
                                                          public static void main(String[] args) {
                                                              File f = new File("c:test.png");
                                                              System.out.println(file2Base64(f));
                                                          }
                                                      
                                                          public static String file2Base64(File file) {
                                                              if (file == null) {
                                                                  return null;
                                                              }
                                                              String base64 = null;
                                                              FileInputStream fin = null;
                                                              try {
                                                                  fin = new FileInputStream(file);
                                                                  byte[] buff = new byte[fin.available()];
                                                                  fin.read(buff);
                                                                  base64 = Base64.encode(buff);
                                                              } catch (FileNotFoundException e) {
                                                                  e.printStackTrace();
                                                              } catch (IOException e) {
                                                                  e.printStackTrace();
                                                              } finally {
                                                                  if (fin != null) {
                                                                      try {
                                                                          fin.close();
                                                                      } catch (IOException e) {
                                                                          e.printStackTrace();
                                                                      }
                                                                  }
                                                              }
                                                              return base64;
                                                          }
                                                      }
                                                    
                                                  
 

意见反馈

0/500