短信签名 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

功能说明

创建短信签名

调用地址

POST https://api.sms.jpush.cn/v1/sign

请求示例

请注意，content-type 为 multipart/form-data 的方式。

curl -X POST \ https://api.sms.jpush.cn/v1/sign \ -u '7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1' \ -H 'content-type: multipart/form-data' \ -F 'sign=申请的签名' -F 'type=签名类型' -F 'remark=申请说明'

          curl -X POST \
  https://api.sms.jpush.cn/v1/sign \
  -u '7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1' \
  -H 'content-type: multipart/form-data' \
  -F 'sign=申请的签名'
  -F 'type=签名类型'
  -F 'remark=申请说明'

此代码块在浮窗中显示

参数

KEY	REQUIRE	DESCRIPTION
sign	TRUE	签名内容仅支持中英文、数字组成，长度为 2~8 个字无须添加【】、[]、（）等符号。范例：极光推送
type	FALSE	签名类型，填写数字代号即可 1、公司名称全称或简称：需提供签名所属主体的营业执照复印件图片及对应法人代表的身份证正反面复印件图片，均需加盖公章 2、工信部备案的网站全称或简称：需提供签名所属的已备案的 icp 备案截图复印件图片、主办单位的营业执照复印件图片及对应法人代表的身份证正反面复印件图片，均需加盖公章 3、APP 应用名称或简称：需提供签名所属的任意应用商店的下载链接、APP 软著证明复印件图片及开发者的营业执照复印件图片、对应法人代表的身份证正反面复印件图片，均需加盖公章 4、公众号小程序全称或简称：需提供签名所属的公众号小程序含主体的页面截图、开发者主体营业执照复印件图片、对应法人代表的身份证正反面复印件图片，均需加盖公章 5、商标名称全称或简称：需提供签名所属商标注册证书复印件图片及商标主体营业执照复印件图片、对应法人代表身份证正反面复印件图片，均需加盖公章 6、其他：申请的签名与所属主体不一致或涉及第三方权益时，需提供第三方授权委托书、第三方签名相关资质（详见类型 1-5），授权委托书格式参考文档。如果用户 A 创建自用签名，签名归属主体属于 A，则不涉及第三方权益。如果用户 A 替公司 B 创建签名，签名归属主体属于公司 B，则涉及第三方权益，需要公司 B 给予 A 授权委托书。公司 B 为授权方，A 为被授权方，并需要加盖公司 B 的公章。
image0	FALSE	请提供签名相关的资质证件图片 1（文件支持 PNG、JPG、JPEG 格式，且大小不超过 2M）
image1	FALSE	请提供签名相关的资质证件图片 2（文件支持 PNG、JPG、JPEG 格式，且大小不超过 2M）
remark	FALSE	请简略描述您的业务使用场景，不超过 100 个字

返回示例

请求成功

{ "sign_id": 37582 }

          { "sign_id": 37582 }

此代码块在浮窗中显示

请求失败

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

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

此代码块在浮窗中显示

修改签名API

功能说明

修改审核不通过的签名，并再次提交审核

调用地址

POST https://api.sms.jpush.cn/v1/sign/{sign_id}

请求示例

curl -X POST \ https://api.sms.jpush.cn/v1/sign/37582 \ -u '7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1' \ -H 'content-type: multipart/form-data' \ -F 'sign=修改的签名' -F 'type=签名类型' -F 'remark=业务场景说明'

          curl -X POST \
  https://api.sms.jpush.cn/v1/sign/37582 \
  -u '7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1' \
  -H 'content-type: multipart/form-data' \
  -F 'sign=修改的签名'
  -F 'type=签名类型'
  -F 'remark=业务场景说明'

此代码块在浮窗中显示

参数

KEY	REQUIRE	DESCRIPTION
sign	TRUE	签名内容仅支持中英文、数字组成，长度为 2~8 个字无须添加【】、[]、（）等符号。范例：极光推送
type	FALSE	签名类型，填写数字代号即可 1、公司名称全称或简称：需提供签名所属主体的营业执照复印件图片及对应法人代表的身份证正反面复印件图片，均需加盖公章 2、工信部备案的网站全称或简称：需提供签名所属的已备案的 icp 备案截图复印件图片、主办单位的营业执照复印件图片及对应法人代表的身份证正反面复印件图片，均需加盖公章 3、APP 应用名称或简称：需提供签名所属的任意应用商店的下载链接、APP 软著证明复印件图片及开发者的营业执照复印件图片、对应法人代表的身份证正反面复印件图片，均需加盖公章 4、公众号小程序全称或简称：需提供签名所属的公众号小程序含主体的页面截图、开发者主体营业执照复印件图片、对应法人代表的身份证正反面复印件图片，均需加盖公章 5、商标名称全称或简称：需提供签名所属商标注册证书复印件图片及商标主体营业执照复印件图片、对应法人代表身份证正反面复印件图片，均需加盖公章 6、其他：申请的签名与所属主体不一致或涉及第三方权益时，需提供第三方授权委托书、第三方签名相关资质（详见类型 1-5），授权委托书格式参考文档。如果用户 A 创建自用签名，签名归属主体属于 A，则不涉及第三方权益。如果用户 A 替公司 B 创建签名，签名归属主体属于公司 B，则涉及第三方权益，需要公司 B 给予 A 授权委托书。公司 B 为授权方，A 为被授权方，并需要加盖公司 B 的公章。
image0	FALSE	请提供签名相关的资质证件图片 1（图片支持 PNG、JPG、JPEG 格式，且大小不超过 2M）
image1	FALSE	请提供签名相关的资质证件图片 2（图片支持 PNG、JPG、JPEG 格式，且大小不超过 2M）
remark	FALSE	请简略描述您的业务使用场景，不超过 100 个字

返回示例

请求成功

{ "sign_id": 37582 }

          { "sign_id": 37582 }

此代码块在浮窗中显示

请求失败

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

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

此代码块在浮窗中显示

查询签名API

功能说明

查询短信签名

调用地址

GET https://api.sms.jpush.cn/v1/sign/{sign_id}

请求示例

curl --insecure -X GET -v https://api.sms.jpush.cn/v1/sign/37582 -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1"

          curl --insecure -X GET -v https://api.sms.jpush.cn/v1/sign/37582 -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1"

此代码块在浮窗中显示

返回示例

请求成功

{ "sign_id": 37582, "sign": "极光推送", "status": 1, //签名审核状态,1为通过，2为未通过 "is_default": 1, //签名使用状态，1为默认签名 "use_status": 1 //签名使用状态，1为使用中，0为未使用 }

          {
  "sign_id": 37582,
  "sign": "极光推送",
  "status": 1, //签名审核状态,1为通过，2为未通过
  "is_default": 1, //签名使用状态，1为默认签名
  "use_status": 1 //签名使用状态，1为使用中，0为未使用
}

此代码块在浮窗中显示

请求失败

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

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

此代码块在浮窗中显示

删除签名 API

功能说明

删除短信签名

调用地址

DELETE https://api.sms.jpush.cn/v1/sign/{sign_id}

请求示例

curl --insecure -X DELETE -v https://api.sms.jpush.cn/v1/sign/37582 -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1"

          curl --insecure -X DELETE -v https://api.sms.jpush.cn/v1/sign/37582 -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1"

此代码块在浮窗中显示

返回示例

请求成功

HTTP/1.0 200 Content-Type: application/json Content-Length: 0

          HTTP/1.0 200
  Content-Type: application/json
  Content-Length: 0

此代码块在浮窗中显示

请求失败

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

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

此代码块在浮窗中显示

返回码

点击查看返回码说明