中昱维信国际短信接口文档

为了避免您的账户被软件或个人恶意利用，建议您在接入国际短信应用的时候，做一些防范措施。 这里推荐几种限制方法： 1． IP限制，如：一个IP一天只提交5次 2． 时间限制，如：一分钟同一个号码只能发一次 3． 手机号的限制 如：一个手机号码一天只能发5次 4． 在请求接口前添加相对较复杂的图形验证码 **中昱维信国际短信接口文档详解** 在数字化时代的今天，国际短信服务是企业与全球客户沟通的重要桥梁。中昱维信提供了一种国际短信接口，使得开发者能够方便地集成到自己的应用程序中，实现跨国短信的发送。然而，为了防止账户被恶意利用，确保系统的安全稳定，采取必要的防范措施至关重要。以下将详细介绍该接口的使用方法、安全策略以及常见问题。 **一、安全防范措施** 1. **IP限制**：设定每个IP地址每天最多只能提交5次请求，有效防止恶意刷接口的行为。 2. **时间限制**：规定同一手机号码在一分钟内只能接收到一条短信，防止频繁发送导致的骚扰或滥用。 3. **手机号限制**：设置单个手机号码每天的短信发送上限为5次，保护用户不被过多的短信打扰。 4. **图形验证码**：在调用接口前，需先通过图形验证码验证，增加自动化攻击的难度。 **二、接口调用** 1. **GET提交接口**： - 示例URL：`http://api.isms.veesing.com/webservice/isms.php?method=Submit&account=用户名&password=密码&mobile=手机号码&content=Your verification code is 【变量】` - 注意替换【变量】为随机数字，并确保每次发送使用不同的数字以测试。 2. **POST提交接口**： - 示例URL：`http://api.isms.veesing.com/webservice/isms.php?method=Submit` - 参数同上，但POST方式通常更安全，因为密码等敏感信息不会出现在URL中。 **三、接口参数** - **method**: 指定操作，这里是"Submit"表示发送短信。 - **account**: 用户名，用于身份验证。 - **password**: 可以是APIKEY或者基于用户名、APIKEY、手机号、内容和时间戳生成的签名（MD5加密）。 - **mobile**: 接收短信的手机号码。 - **content**: 验证码，通常为4位数字。 - **time** (POST提交时): Unix时间戳，签名方式时为必填项。 **四、返回值说明** 返回值以JSON格式呈现，包含以下字段： - **Code**: 返回状态码，2表示提交成功，其他数值表示各种错误情况。 - **Imsid**: 成功发送后，会返回消息ID。 - **Msg**: 提交结果的描述信息。 **五、错误代码** 错误代码对应不同的异常情况，如： - 0: 提交失败 - 2: 提交成功 - 400: 非法IP访问 - 401: 账户名不能为空 - 402: 密码不能为空 - 403: 手机号码不能为空 - 4030: 手机号码被列入黑名单 - 404: 短信内容不能为空 - 405: 用户名或密码不正确 - 4050: 账号被冻结 - 4051: 剩余条数不足 - 4052: 访问IP与备案IP不符 - 406: 手机号码格式或国家号不正确 - 407: 短信内容含敏感字符 - 4071: 未提交备案模板 - 4072: 短信内容必须与已报备模板匹配 - 40722: 变量内容超过指定长度 - 4073: 短信内容超出长度限制 - 408: 账户疑似被恶意利用，已自动冻结 **六、余额查询接口** - **method**: "GetNum"，表示查询余额。 - **password**: 同样可以是APIKEY或签名。 - **time**: Unix时间戳（签名方式时必填）。 返回值同样包含Code和Msg字段，Code为2表示查询成功，Num字段显示剩余数量。 **七、生成签名** 签名的生成方法为MD5加密，以PHP为例，包括账号、APIKEY、手机号、内容和时间戳。这提供了更高的安全性，防止中间人攻击。 **八、时间戳参考** Unix时间戳可以在线工具（如 http://tool.chinaz.com/Tools/unixtime.aspx）查询或转换。 综上，中昱维信的国际短信接口提供了全面的安全机制和详细的错误处理，便于开发者高效且安全地实现国际短信的发送和管理。在实际使用中，应遵循上述安全建议，并熟悉错误代码以便快速排查问题。