5G视信模板发送

1、概述

5G视信通过模板ID发送消息

2、接口地址

POST https://rcsapi.hanwg.com/v1/mms/send

3、请求参数

3.1、请求路径参数

见全局参数

3.2、请求头参数

见接口权限校验

3.3、请求体参数

名称	数据类型	是否必有	描述
cmdId	string	是	命令ID，固定值002
templateNo	string	是	上传彩信的模板ID
mobiles	string	是	接收手机号码，多个手机号码用英文逗号分隔,最多支持200个号码
subcode	string	否	短信签名对应子码(平台提供)+自定义扩展子码(选填)，必须是数字
templateParams	string	否	模板变量内容，多个时用#####按顺序拼接，确保变量个数正确及各个变量值在限定范围内，无模板变量时该值不填。若变量为图片变量，拼接内容为图片名称,图片名称不要带除“.”以外的特殊字符，推荐文件名采用md5小写编码，文件名需要带文件名后缀。例：上海#####5eac43aceba42c8xxx.jpg
medias	object	否	图片变量，文件名需要带上后缀，格式为： { “文件名”：”文件BASE64内容” } 示例： { “5eac43aceba42c8xxx.jpg”: “XXXXXX” }

4、请求示例

POST http://172.18.2.32:8002/v1/http/mms/send 
Authorization:
ZGgxODUyODpkOGVmZThkNDIwMDA0OWEzNTVkZDlkMDg3YzRjYzExYw==
Date: 2023-05-15 09:55:01
Content-Type: application/json
Accept: */*
Host:     127.0.0.1:8002
Accept-Encoding: gzip, deflate, br
Connection: keep-alive

{
    "cmdId": "002",
    "templateNo": "51d148589a37439f87ec6c72804xxx",
    "mobiles": "130520369**,130520369**,130520369",
    "subcode": "3333",
    "templateParams": "上海#####上海#####上海#####上海木雕#####城隍庙五香豆#####嘉定竹刻#####5eac43aceba42c8757b54003a58277b5.jpg",
    "medias":{
        "5eac43aceba42c8757b54003a58277b5.jpg":"/9j/4AAQSkZJRgABAQEASABIAAD/2wBDABkRExYTEBkWFBYcGxkeJ..."
    }
}

5、响应参数

名称		数据类型	是否必有	描述
result		int	是	响应状态码
msg		string	是	模板审核描述
msgId		string	条件	批次号Id
response		Array[object]	条件	响应体（提交成功号码和失败号码）
	status	Integer	条件	0是提交成功, 其他错误码标识不成功
	mobiles	string	条件	对应状态码的号码，多个号码以英文逗号分割

6、响应示例

{
    "result": 0,
    "msg": "无错误，命令正确接收",
    "msgId": "4e95953480af4a41977a56ec3ba7f13e",
    "response": [
        {
            "status": 0,
            "mobiles": "130520369**,130520369**"
        },
        {
            "status": 4,
            "mobiles": "130520369"
        }
    ]
}

文档更新时间: 2025-12-17 10:38 作者：王超