普通发送接口（一对多发送）

更新时间：2022-11-16

特别提醒
根据运营商相关要求，短信/彩信只能向其客户、会员或内部员工的手机号码发送与本企业业务相关的通知类短信、验证码、注册码类短信，以及符合国家法律法规的营销类信息等，如您在接入调试等阶段需要测试，请务必使用自己的手机号码进行发送测试，切勿使用他人，或者随意编纂号码进行发送，以免因用户投诉等引起不必要的法律和安全风险。请务必重视并遵守执行。

1.功能说明

1.1.该接口适用于：直接将【短信前缀】和【短信内容】放在接口中请求发送短信，无需事先申请【签名ID】和【模板ID】，但是会进入人工审核（除非客服配置免审）；
1.2.使用该接口，可以给单个号码发送短信，或者给多个号码群发相同内容短信；
1.3.接口发送调用地址：http(s)://api.guoyangyun.com/api/sms/sendSmsApi.htm
1.4.请求方式：以HTTP POST请求的方式（推荐使用post方式）。
1.5.汉字字符集：UTF-8，请注意参数的大小写。

2.输入参数

参数	名称	类型	必须	描述
公共参数	公共参数	—	是	详见《公共参数和配置》文档
mobile	发送手机号码	String	是	1.多个号码用英文半角逗号分开。 2.每个包最大可支持3000个号码。
content	发送短信内容	String	是	1.使用UTF-8编码。 2.签名可以包含在内容中。 3.总长度不超过500字。
smsid	消息ID	String	否	1.消息ID是这个包唯一标识，若为空则系统随机分配一个唯一标识值。 2.若不为空，由用户自己设置一个唯一标识值。 3.该值做为应答及状态报告中的消息ID一一对应。
instanceid	产品账户ID	String	否	用于指定扣费的产品账户，如果传入该参数，资费将从指定的产品账户扣减。（需客服开通权限后方能生效）
subport	扩展端口	String	否	1.空表示不需要扩展。 2.扩展必须是2位数字（若扩展输入00则手机收到端口号为：10657*****00）。 3.扩展必须此帐户配置通道支持。
sendtime	定时发送时间	String	否	1.为空表示立即发送。 2.定时格式：yyyy-mm-dd hh:mm:ss 3.定时时间应设置在当前时间的15分钟后。

3.调用示例

3.1 浏览器测试样例

特别提醒
根据运营商相关要求，短信/彩信只能向其客户、会员或内部员工的手机号码发送与本企业业务相关的通知类短信、验证码、注册码类短信，以及符合国家法律法规的营销类信息等，如您在接入调试等阶段需要测试，请务必使用自己的手机号码进行发送测试，切勿使用他人，或者随意编纂号码进行发送，以免因用户投诉等引起不必要的法律和安全风险。请务必重视并遵守执行。

http(s)://api.guoyangyun.com/api/sms/sendSmsApi.htm?appkey=123456&appsecret=448484484&mobile=15000000000,17300000000&content=【签名】测试内容

3.2 请求示例下载

Curl	Java	C#	PHP	Python	ObjectC
	下载

4.Json返回

4.1.返回参数

参数	名称	类型	描述
code	错误码	String	提交返回结果。0：表示成功，其他：失败。（状态码详见：《公共错误代码定义》）
msg	返回信息	String	返回信息。
smsid	消息ID	String	1.消息ID是这个包唯一标识，若为空则系统随机分配一个唯一标识值。 2.若不为空，由用户自己设置一个唯一标识值。 3.该值做为应答及状态报告中的消息ID一一对应。
failed	失败记录	List	错误的记录数据，多个之间用英文逗号分开

4.2.调用成功样例

{
    "code":"0",
    "msg":"成功",
    "smsid":"1234554444ddd5",
    "failed":["123","abc"]}    // 错误的号码记录
}

4.3.调用失败样例

{
    "code":"XXXX",
    "msg":"错误提示内容"
}

results matching ""

No results matching ""