• 调用说明
  • 统一请求格式
    • BASE URL：
    • URL格式：
  • 提高发送速度建议

    调用说明

    云片短信API是使用HTTP并遵循REST原则设计的Web服务接口，您可以使用几乎任何客户端和任何编程语言与REST API进行交互。通过发送简单的HTTP POST请求就可以轻松接入使用。

    注：云片网为确保您的账户和信息安全，请在功能上线前进入后台添加您要使用的IP地址到IP白名单列表中

    统一请求格式

    BASE URL：

    1. https://{type}.yunpian.com/{version}

    其中，{type}为业务类型，如短信为sms，语音为voice，流量为flow；{version}为版本号，如当前的版本号为v2

    URL格式：

    1. /{resource}/{function}.{format}

    说明： {resource}为资源名，通常对应一类API

    {function}为该资源提供的操作方法

    {format}表示请求响应的结果格式

    比如查账户信息的url为：https://sms.yunpian.com/v2/user/get.json 表示调用user的get方法，并且返回json格式的字符串。 我们目前已经提供的接口，请参考API。

    HTTP头信息: 

    1. Accept:application/json;charset=utf-8;
    2. Content-Type:application/x-www-form-urlencoded;charset=utf-8;

    说明：

    请求方式(Method)：统一用POST方式编码：UTF-8最佳实践：

    • 请使用发短信接口 可以自动匹配模板，开发更简单
    • 请设置好IP白名单 IP白名单可以有效提高账户安全性
    • 请补充完整您的账户资料信息 包括设置余额提醒阈值、联系人和紧急联系人的联系方式等账户信息，方便我们提供更好的服务

    提高发送速度建议

    • 配置合适的线程数，避免网络拥塞导致您延迟增加。不同带宽下，推荐使用的连接类型和线程数。

    • 海外用户可以调用海外服务器地址us.yunpian.com,获得更快的请求和处理速度。例如使用短信接口时，将sms.yunpian.com替换为us.yunpian.com即可。