创建短信签名接口
温馨提示
- 国内短信签名由【】和签名内容组成,格式为【签名内容】。 建议国内短信签名内容尽量使用中文。
- 签名请以公司简称或品牌名称命名,不规范签名的短信将会驳回
- 审核时间:每日9:00~18:00期间提交,预计30分钟内完成审核,如需加急可联系在线商务处理
请求说明
- 接口请求域名 : api.ffrcs.cn
- RequestURI : /rest/sms/v3/signature/add
- Method : POST
- Content-Type : application/json; charset=utf-8;
默认接口请求频率限制:2次/秒。
输入参数
参数 | 类型 | 描述 | 示例 | 必填 |
---|---|---|---|---|
signName | String | 短信签名内容 (需要携带【】) | 【飞鱼短信】 | 是 |
signPurpose | Integer | 签名用途。 1:自用。签名为本账号企业实名认证的公司、网站、产品名等 2:他用。签名为非本账号实名认证的公司、网站、产品名等 他用类型需要提供签名所属公司信息和责任人信息。 | 1 | 是 |
signType | Integer | 签名类型。0:公司全称 1:公司简称 2:APP 3:网站 4:小程序 5:公众号 6:商标 7:政府/机关事业单位/其他机构 | 1 | 是 |
description | String | 请输入签名申请用途。 | 否 | |
operatorName | String | 经办人姓名。 | 是 | |
operatorTel | String | 经办人手机号。 | 是 | |
operatorId | String | 经办人身份证号码。 | 是 | |
operatorIdFrontImage | String | 经办人身份证正面照。 请上传 png、jpg、jpeg 格式文件,大小2MB 以内。图片需先进行 base64 编码格式转换,将转换后的字符串赋值给该参数。 | data:image/png;base64,iVBORw0K | 是 |
operatorIdBackImage | String | 经办人身份证反面照。 请上传 png、jpg、jpeg 格式文件,大小2MB 以内。图片需先进行 base64 编码格式转换,将转换后的字符串赋值给该参数。 | data:image/png;base64,iVBORw0K | 是 |
creditCode | String | 为他人申请的公司统一社会信用代码。 | 否 | |
corporation | String | 为他人申请的公司名称。 | 否 | |
businessLicenseImage | String | 为他人申请的公司营业执照图片。 请上传 png、jpg、jpeg 格式文件,大小2MB 以内。图片需先进行 base64 编码格式转换,将转换后的字符串赋值给该参数。 | data:image/png;base64,iVBORw0K | 否 |
powerOfAttorneyImage | String | 为他人申请的授权委托书。 请上传 png、jpg、jpeg 格式文件,大小2MB 以内。图片需先进行 base64 编码格式转换,将转换后的字符串赋值给该参数。 | data:image/png;base64,iVBORw0K | 否 |
legalPersonName | String | 责任人姓名。 | 否 | |
legalPersonId | String | 责任人身份证号码。 | 否 | |
legalPersonIdFrontImage | String | 责任人身份证正面照。 请上传 png、jpg、jpeg 格式文件,大小2MB 以内。图片需先进行 base64 编码格式转换,将转换后的字符串赋值给该参数。 | data:image/png;base64,iVBORw0K | 否 |
legalPersonIdBackImage | String | 责任人身份证反面照。 请上传 png、jpg、jpeg 格式文件,大小2MB 以内。图片需先进行 base64 编码格式转换,将转换后的字符串赋值给该参数。 | data:image/png;base64,iVBORw0K | 否 |
响应内容
参数 | 类型 | 描述 |
---|---|---|
code | Integer | 响应状态 |
message | String | 响应状态描述 |
data | Object | 数据节点 |
data.signId | Integer | 返回的短信签名ID |
示例
请求示例
curl 'https://api.ffrcs.cn/rest/sms/v3/signature/add' \
--header 'Content-Type: application/json' \
--header 'X-FZ-Timstamp: 1713152159772 ' \
--header 'Authorization: HmacSHA256 credential=1kl***,signature=1264b693*******be05bef' \
--data '{
"signName": "【飞鱼短信】",
"signPurpose": 1,
"signType": 1,
"operatorName": "张三",
"operatorTel": "180********",
"operatorId":" 411********"
"operatorIdFrontImage":"data:image/png;base64,iVBORw0K***"
"operatorIdBackImage":"data:image/png;base64,iVBORw0K***"
}'
响应示例
{
"code": 200,
"message": "处理成功",
"data": {
"signId": 12973
}
}
错误码参考- 错误码