request URL
http://ip:port/sms/v2/std/multi_send
request method
POST
Request parameter description
| parameter |
Types of |
Is it necessary |
describe |
Example |
| userid |
string |
Yes |
User account: maximum length of 6 characters , unified capitalization |
Example: J10003 |
| pwd |
string |
Yes |
User password: fixed-length lowercase 32 characters. For password rules, see " 3.1 Authentication Rules " |
Example: Password plaintext mode: 111111 Password encryption mode: Account: J10003 Password: 111111 Fixed string: 00000000 Timestamp: 0803192020 The corresponding string before MD5 encryption: J10003000000001111110803192020 Password string after MD5 encryption : 26dad7f364507df18f3841cc9c4ff94d |
| timestamp |
string |
no |
Timestamp: 24 -hour format: MMDDHHMMSS , that is, month, day, hour, minute, second, fixed length of 10 digits , if each segment of month, day, hour, minute, and second is less than 2 digits, add 0 to the left . This parameter is required when MD5 encryption method is selected for the password . , you do not need to fill in the password when the password is in plain text. |
Example: 0803192020 |
| multimt |
string |
Yes |
Personalized information details: see Table 3-2 below . Personalized information of up to 100 mobile phone numbers can be supported in multimt |
|
Table 3-1
Multimt package structure parameter description:
| parameter |
Types of |
Is it necessary |
describe |
Example |
| mobile |
string |
Yes |
Single mobile phone number: Please refer to " 3.2 Mobile phone number rules " for details on the number rules |
|
| content |
string |
Yes |
SMS content: maximum support 350 characters, one letter or one Chinese character is regarded as one character. Encoding: |
Example: SMS content: "Welcome to use this interface" After the text message content is urlencode encoded: %b2%e2%ca%d4%b6%cc%d0%c5 |
| svrtype |
string |
no |
业务类型：最大可支持10个长度的英文字母、数字组合的字符串 |
示例：SMS001 |
| exno |
string |
否 |
扩展号：长度不能超过6位，注意通道号+扩展号的总长度不能超过20位，若超出则exno无效，如不需要扩展号则不用提交此字段或填空 |
示例：0006 |
| custid |
string |
否 |
用户自定义流水号：该条短信在您业务系统内的ID，比如订单号或者短信发送记录的流水号。填写后发送状态返回值内将包含这个用户自定义流水号。 最大可支持64位的ASCII字符串：字母、数字、下划线、减号，如不需要则不用提交此字段或填空 |
示例： b3d0a2783d31b21b8573 |
| exdata |
string |
否 |
自定义扩展数据：额外提供的最大64个长度的ASCII字符串：字母、数字、下划线、减号，作为自定义扩展数据，填写后，状态报告返回时将会包含这部分数据，如不需要则不用提交此字段或填空 |
|
表 3-2
返回参数说明
| 参数 |
类型 |
描述 |
示例 |
| result |
int |
个性化群发请求处理结果： 0：成功 非0：失败，详见4错误代码表 |
示例：0 |
| msgid |
long (64位) |
平台流水号：返回个性化群发第一条记录中的msgid，非0，64位整型， 对应Java和C#的long，不可用int解析。 result非0时，msgid为0 |
示例： 9223372036854775808 注意：msgid允许出现负数 |
| custid |
string |
用户自定义流水号：返回网关生成的平台流水号 result非0时，custid为空 |
|
表 3-3