Home Support SMS API

Upload MMS Attachments

Description: Upload MMS attachments.

Request Parameters Description:

Parameters Description Required Type

fileType

MMS attachment type, support: [png,jpg,jpeg,bmp,gif,webp,psd,svg,tiff,mp3,wav,txt,vcf]

Yes

String

fileData

MMS file base64 encrypted transfer. The maximum size of an MMS attachment is 50kb, and a single task can carry up to 3 MMS files. (For base64 code conversion, please refer to the JAVA sample code at the very bottom of the program)

Yes

String

Request URL：

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

Request Sample (to upload a txt attachment with the attachment content of "123456"):

                                                
                                                    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"
                                                    }

Request Sample (upload png attachment):

                                                
                                                    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"
                                                    }

Response Parameters Description：

Parameters Description Type

status

Response code, "0"means successful, others than 0 means failure, seeing Status code description

String

reason

Failure Reason Description

String

data

Upload attachment id, valid for 3 days, can be used to send MMS repeatedly within 3 days

String

Response Sample:

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

Sample code for Java-base64 code conversion:

                    
                      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;
                          }
                      }
 

Feedback

0/500
✖
Service Support
1. Requirements Type
2. Requirements Description
3. Email

Need help?

Click here and start chatting with us!