短信发送 API
最近更新:2021-12-15
展开全部

短信发送 API

  • 支持发送文本、语音验证码短信
  • 支持验证验证码
  • 支持发送单条、批量模板短信

HTTP 验证

使用 HTTP Basic Authentication 的方式做访问授权。这样整个 API 请求可以使用常见的 HTTP 工具来完成,比如:curl,浏览器插件等;

HTTP Header(头)里加一个字段(Key/Value 对):

Authorization: Basic base64_auth_string
          Authorization: Basic base64_auth_string

        
此代码块在浮窗中显示

其中 base64_auth_string 的生成算法为:base64(appKey:masterSecret),即:对 appKey 加上冒号,加上 masterSecret 拼装起来的字符串,再做 base64 转换。appKey、masterSecret 可以在控制台应用设置中查看。


发送文本验证码短信 API

功能说明

  • 发送文本验证码短信

调用地址

请求示例

curl --insecure -X POST -v https://api.sms.jpush.cn/v1/codes -H "Content-Type: application/json" \ -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1" -d '{"mobile":"xxxxxxxxxxx","sign_id":*,"temp_id":*}'
          curl --insecure -X POST -v https://api.sms.jpush.cn/v1/codes -H "Content-Type: application/json" \
-u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1" -d '{"mobile":"xxxxxxxxxxx","sign_id":*,"temp_id":*}'

        
此代码块在浮窗中显示

参数

KEY REQUIRE DESCRIPTION
mobile TRUE 手机号码
sign_id FALSE 签名 ID,该字段为空则使用应用默认签名
temp_id TRUE 模板 ID

返回示例

发送成功

{"msg_id": "288193860302"}
          {"msg_id": "288193860302"}

        
此代码块在浮窗中显示

发送失败

{ "error": { "code": *****, "message": "******" } }
          {
    "error": {
        "code": *****,
        "message": "******"
    }
}

        
此代码块在浮窗中显示

发送语音验证码短信 API

功能说明

  • 发送语音验证码短信

调用地址

请求示例

curl --insecure -X POST -v https://api.sms.jpush.cn/v1/voice_codes -H "Content-Type: application/json" \ -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1" -d '{"mobile":"xxxxxxxxxxxxxx", "ttl":60}'
          curl --insecure -X POST -v https://api.sms.jpush.cn/v1/voice_codes -H "Content-Type: application/json" \
-u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1" -d '{"mobile":"xxxxxxxxxxxxxx", "ttl":60}'

        
此代码块在浮窗中显示

参数

KEY REQUIRE DESCRIPTION
mobile TRUE 手机号码
code FALSE 语音验证码的值,验证码仅支持 4-8 个数字
voice_lang FALSE 语音验证码播报语言选择,0:中文播报,1:英文播报,2:中英混合播报
ttl FALSE 验证码有效期,默认为 60 秒

返回示例

发送成功

{"msg_id": "288193860302"}
          {"msg_id": "288193860302"}

        
此代码块在浮窗中显示

发送失败

{ "error": { "code": *****, "message": "******" } }
          {
    "error": {
        "code": *****,
        "message": "******"
    }
}

        
此代码块在浮窗中显示

验证码验证 API

功能说明

  • 验证验证码是否有效

调用地址

请求示例

curl --insecure -X POST -v https://api.sms.jpush.cn/v1/codes/288193860302/valid -H "Content-Type: application/json" \ -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1" -d '{"code":"123456"}'
          curl --insecure -X POST -v https://api.sms.jpush.cn/v1/codes/288193860302/valid -H "Content-Type: application/json" \
-u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1" -d '{"code":"123456"}'

        
此代码块在浮窗中显示

参数

KEY REQUIRE DESCRIPTION
code TRUE 验证码

返回示例

验证通过

{ "is_valid": true }
          {
    "is_valid": true
}

        
此代码块在浮窗中显示

验证不通过

{ "is_valid": false, "error": { "code": *****, "message": "******" } }
          {
    "is_valid": false,
    "error": {
        "code": *****,
        "message": "******"
    }
}

        
此代码块在浮窗中显示

发送单条模板短信 API

功能说明

  • 发送单条模板短信

调用地址

请求示例

curl --insecure -X POST -v https://api.sms.jpush.cn/v1/messages -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1" \ -d '{"mobile":"xxxxxxxxxxxxxx","sign_id":*,"temp_id":1,"temp_para":{"xxxx":"xxxx"}}'
          curl --insecure -X POST -v https://api.sms.jpush.cn/v1/messages -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1" \
-d '{"mobile":"xxxxxxxxxxxxxx","sign_id":*,"temp_id":1,"temp_para":{"xxxx":"xxxx"}}'

        
此代码块在浮窗中显示

参数

KEY REQUIRE DESCRIPTION
mobile TRUE 手机号码
sign_id FALSE 签名 ID,该字段为空则使用应用默认签名
temp_id TRUE 模板 ID
temp_para FALSE 模板参数,需要替换的参数名和 value 的键值对

返回示例

发送成功

{ "msg_id": 288193860302 }
          { "msg_id": 288193860302 }

        
此代码块在浮窗中显示

发送失败

{ "error": { "code": *****, "message": "******" } }
          {
    "error": {
        "code": *****,
        "message": "******"
    }
}

        
此代码块在浮窗中显示

发送批量模板短信 API

功能说明

  • 发送批量模板短信

调用地址

请求示例

curl --insecure -X POST -v https://api.sms.jpush.cn/v1/messages/batch -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1" -d \ '{ "sign_id": *, "temp_id": 1250, "tag":"标签", "recipients": [ { "mobile": "13812345678", "temp_para": { "number": "741627" } }, { "mobile": "18603050709", "temp_para": { "number": "147721" } } ] }'
          curl --insecure -X POST -v https://api.sms.jpush.cn/v1/messages/batch -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1" -d \
'{
    "sign_id": *,
    "temp_id": 1250,
    "tag":"标签",
    "recipients": [
        {
            "mobile": "13812345678",
            "temp_para": {
                "number": "741627"
            }
        },
        {
            "mobile": "18603050709",
            "temp_para": {
                "number": "147721"
            }
        }
    ]
}'

        
此代码块在浮窗中显示

参数

KEY REQUIRE DESCRIPTION
sign_id FALSE 签名 ID,该字段为空则使用应用默认签名
temp_id TRUE 模板 ID
tag FALSE 标签
recipients TRUE 接收者列表
recipients.mobile TRUE 手机号码
recipients.temp_para FALSE 模板参数,需要替换的参数名和 value 的键值对

返回示例

发送成功

{ "success_count": 1, "failure_count": 1, "recipients": [ { "msg_id": "274887115920", "mobile": "13812345678" }, { "error_code": "50006", "error_message": "invalid mobile", "msg_id": "274887115920", "mobile": "18603050709", "temp_para": { "number": "147721" } } ] }
          {
  "success_count": 1,
  "failure_count": 1,
  "recipients": [
    {
      "msg_id": "274887115920",
      "mobile": "13812345678"
    },
    {
      "error_code": "50006",
      "error_message": "invalid mobile",
      "msg_id": "274887115920",
      "mobile": "18603050709",
      "temp_para": {
        "number": "147721"
      }
    }
  ]
}

        
此代码块在浮窗中显示

发送失败

{ "error": { "code": *****, "message": "******" } }
          {
    "error": {
        "code": *****,
        "message": "******"
    }
}

        
此代码块在浮窗中显示

返回码

点击查看返回码说明

文档内容是否对您有帮助?

Copyright 2011-2022, jiguang.cn, All Rights Reserved. 粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

在文档中心打开