1 应用接入配置表
| 能力 | 配置项 | 说明 |
| 短信能力 | 短信签名 | 用于发送短信，若要使用短信能力，必须设置，并且需要经过审核 |
| 短信模板 | 1、系统短信模板不需要进行审核 2、自定义短信模板需要进行审核才能使用 | |
| 每天短信上限 | 设置限制每天短信发送数量，默认不限制 | |
| 短信发送报告回调地址 | 设置短信发送报告回调地址，用于容能云将短信发送结果回调给应用服务器 | |
| 流量能力 | 流量开关 | 开启使用流量能力的开关，开启后才能正式使用流量能力 |
| 流量押金 | 需要缴交10000的流量押金后，才能使用流量能力 | |
| 流量回调地址 | 用于容能云讲流量充值结果回调给应用服务器 |
2 用户能力接入
2.1 托管用户鉴权
√ 托管用户直接集成Android或iOS的sdk。用户发起访问后，sdk自动请求容能云的用户能力。
√ 托管用户鉴权通讯架构图
2.2 非托管用户鉴权
2.2.1 非托管用户鉴权通讯架构图
2.2.2 获取token
√ 接口地址
| 接口地址 | https://i.ipower.cn/a/appServerJson/loginIn |
| 请求方式 | post |
| 数据类型 | json |
√ 请求参数
| 参数名称 | 参数类型 | 参数说明 |
| userId | String | 应用用户id |
json 请求示例
{
"userId" : "14fa47d8e7e041b48fe25565a87ff02d"
}√ 响应参数
| 参数名称 | 参数类型 | 参数说明 | |
| resultCode | String | 响应编码 | |
| msg | String | 响应消息 | |
| verify | random | 响应随机数，6位随机数 | |
| time | 响应时间,单位毫秒 | ||
| signature | 响应签名 | ||
| data | requestNo | String | 请求号 |
| token | String | 返回token | |
json响应示例
{
"resultCode": "1000",
" msg ": "请求成功",
"verify": {
"random": "806274",
"time": "1500532397",
" signature": "7a308a0b3d16fa58a3f6cf0326f369933253de68",
},
"data": {
" requestNo": "14fa47d8e7e041b48fe25565a87ff02d",
"token": "yD1OwHaIK9aegWs8NIxk/SRudCY5IY2kZeJz1Z+GT+0Nml4F9qsElXlAccWvxk1IfYzyy
2tweudxDzKHZuTUA=="
}
}2.2.3 用户登出
√ 接口地址
| 接口地址 | https://i.ipower.cn/a/appServerJson/loginOut |
| 请求方式 | post |
| 数据类型 | json |
√ 请求参数
| 参数名称 | 参数类型 | 参数说明 |
| userId | String | 应用用户id |
json请求示例
{
"userId" : "14fa47d8e7e041b48fe25565a87ff02d"
}√ 响应参数
| 参数名称 | 参数类型 | 参数说明 |
| resultCode | String | 响应编码 |
| msg | String | 响应消息 |
| verify | random | 响应随机数，6位随机数 |
| time | 响应时间,单位毫秒 | |
| signature | 响应签名 | |
| data | object | 返回数据 |
json响应示例
{
"resultCode": "1000",
" msg ": "移除token成功",
"verify": {
"random": "806274",
"time": "1500532397",
" signature": "7a308a0b3d16fa58a3f6cf0326f369933253de68",
},
"data": {
}
}3 流量能力接入
3.1 流量能力接入流程图
3.2 流量能力配置参数
| 能力 | 配置项 | 说明 |
| 流量能力 | 流量开关 | 开启使用流量能力的开关，开启后才能正式使用流量能力 |
| 流量押金 | 流量能力需要缴交流量押金后使用 | |
| 流量回调地址 | 用于容能云将流量充值结果回调给应用服务器 |
3.3 运营商的流量套餐表
流量套餐表下载：流量包套餐.xlsx
| 移动(单位：M) | 电信(单位：M) | 联通(单位：M) |
| ── | 5 | ── |
| 10 | 10 | ── |
| ── | ── | 20 |
| 30 | 30 | 30 |
| 50 | 50 | 50 |
| 70 | ── | ── |
| 100 | 100 | 100 |
| ── | 200 | 200 |
| 150 | ── | ── |
| 300 | ── | 300 |
| 500 | 500 | 500 |
| 1024 | 1024 | 1024 |
| 2048 | ── | ── |
3.4 流量能力接入审核
√ 审核周期：预计3个工作日
√ 申请提交的资料：营业执照副本, 税务登记证副本, 组织机构代码证副本, 一般纳税人证
3.5 平台流量钱包套餐充值
| 支持运营商 | 省内流量 | 全国流量 | 有效期 | 到账时间 | 充值频率 | 充值限制 |
| 中国移动 | √ | √ | 当月有效 | 24小时内 | 无限制 | 月末最后二天不能充值 |
| 中国电信 | √ | √ | 当月有效 | 24小时内 | 无限制 | 月初第一天和月末最后一天不能充值 |
| 中国联通 | √ | √ | 当月有效 | 24小时内 | 无限制 | 月末最后一天不能充值 |
3.6 流量能力接入文档
4 短信能力接入
4.1 短信能力接入流程图
4.2 短信能力接入配置
| 能力 | 配置项 | 说明 |
| 短信能力 | 短信签名 | 用于发送短信，若要使用短信能力，必须设置，并且需要经过审核 |
| 短信模板 | 1、系统短信模板不需要进行审核 2、自定义短信模板需要进行审核才能使用 | |
| 每天短信上限 | 可以根据需要设置限制每天短信发送数量，默认不限制 | |
| 短信发送报告回调地址 | 设置短信发送报告回调地址，用于容能云将短信发送结果回调给应用服务器 |
4.3 短信签名配置
4.3.1 短信签名格式要求
√ 电信运营商要求每条短信都必须含有签名
√ 签名格式为中文括号加公司简称或者店铺名称等，例如：容能云，建议使用 3-7 个汉字。
√ 可以包含数字、汉字、英文，不能为纯数字、纯英文，且不能包含其他特殊符号。不能是纯数字、纯字母、不含违禁关键词，不能有任何符号(如-.+#)；
√ 签名会自动附加，因此会占用短信的字数，请注意控制内容长度。
√ 不用添加[ ]符号，短信发送会自带[ ]符号,避免重复，申请时无需添加该符号
√ 短信签名建议为用户真实应用名/网站名/公司名，应如实清晰反映内容提供者的名称或者产品，若签名/短信内容侵犯到第三方权益须获得第三方的真实授权,授权委托书等凭证上传管理中心；
√ 新签名审核通过前，旧签名仍可继续使用。
√ 签名内容不能含有违规,违禁关键词如中奖/抽奖/彩票/党政及宗教推广类签名不支持
√ 审核通过后的签名示例：【容能云】。
√ 短信签名申请审核为1个工作日, 预计2小时内审核完成，审核通过后可使用。工作时间:9:00-23:00（法定节日顺延）,建议您尽量在18:00前提交申请.
√ 企业用户可添加5个自定义签名；个人用户可添加1个自定义签名。
√ 签名添加需提交材料:
企业营业执照、组织机构代码证、税务登记证(如已更新为三证合一证件,将三证合一证件上传即可)
4.4 短信模板配置
4.4.1 短信模板配置要求
√ 不能发送营销/贷款/借款/中奖/抽奖类短信,不支持金融理财&房产通知类短信(验证码除外);
√ 短信模板如需链接请提供已ICP备案的网址,短链接不支持拼接;
√ 短信模板首尾不能添加[ ]且任意位置不能添加【】符号;内容不用添加签名; 短信发送字数含"签名+模板内容+变量内容"，短信字数<=70个字数，按照70个字数一条短信计算，短 信字数>70个字数，即为长短信，按照67个字数记为一条短信计算;
√ 企业与个人的短信模板个数不限制
√ 不能发送营销/贷款/维权/彩票/色情/暴力/借款/中奖/抽奖/党政及宗教类短信,不支持慈善募捐,众筹,金融,理财,投资,房产通知类短信(验证码除外);
√ 短信内容不能含有政治敏感字眼和“黄赌毒”等低俗敏感字样,出现违法违规或者损害到相关他人权益的,平台将保留最终追究的权利。
√ 不支持全变量/组合变量短信模板; 请将短信内容的结构具体,细化使用场景;
√ 短信模板不支持特殊符号如,￥, ★,ヾ(●?▽`●)ノ ^_^&;
√ 支持TD或T或N进行短信退订回复,其它回复参数不支持;
√ 模板如需链接请将已ICP备案的网址写于模板非变量内容中便于核实;(短链接不支持拼接地址)
√ 变量名称只能填写英文字母或英文数字组合,首位不能为数字,不能纯汉字,纯数字及email,mobile,id,nick,site;
√ 模板内容含验证码，注册码，校验证请选择验证码模板类型，反之请选择通知类型;
√ 变量格式应如${code},其中$符在{ }外面，变量内容不能为空;
√ 【 】符号在模板内容中任意位置都不能使用, [ ]符号模板内容首尾不能使用,系统均会默认为签名，签名请单独申请，传参需传签名及短信模板ID;
√ 变量名称不能带有任何符号或空格 ;
√ 模板内容如侵犯到第三方权益须获得第三方的授权,并将授权委托凭证上传管理中心;
√ 凭证上传路径:登陆-管理中心-配置管理-验证码/短信通知-配置短信签名-添加签名-签名用途选择:其它/他人产品或业务名(根据业务类型选择)-下载授权书模板-填写对应信息提交 凭证审核
√ 预计2小时内审核完成，审核通过后可使用。工作时间:9:00-23:00 （法定节日顺延）,建议您尽量在18:00前提交申请;
4.4.2 系统默认短信模板
| code | 名称 | 模版内容 |
| 1 | 通用验证码 | 您的验证码是{0}，{1}分钟内有效。为了您的帐号安全，请勿将验证码告知他人。 |
| 2 | 密码找回 | 您正在申请密码找回，验证码是{0}，{1}分钟内有效。为了您的帐号安全，请勿将验证码告知他人。 |
| 3 | 用户登录 | 您的登录验证码是{0}，{1}分钟内有效。如非本人操作，请忽略此短信。 |
| 4 | 异地登录提醒 | 您的帐号在异地登录，请注意帐号安全。如非本人操作，请及时修改密码 |
4.5 短信模板审核
4.5.1 短信模板审核流程
4.6 短信内容条数计算
√ 短信字数＝短信模板内容字数 + 签名字数
√ 短信字数<=70个字数，按照70个字数一条短信计算
√ 短信字数>70个字数，即为长短信，按照67个字数记为一条短信计算
√ 长短信最大支持发送500个字以内的短信。
4.7 短信计费
√ 按照实际使用情况进行实时扣费；运营商返回短信发送成功状态才会扣费；
√ 若短信发送5分钟后还未返回状态，将先扣费，实际返回状态后根据失败条数进行短信量返补。
√ 接口调用失败及运营商返回失败状态，都不会扣费
√ 境外短信按条计费
√ 具体套餐收费请访问官网的价格
4.8 短信发送支持范围
| 运营商/范围 | 境内 | 港澳台 | 国外 |
| 中国移动 | √ | √ | √ |
| 中国电信 | √ | √ | √ |
| 中国联通 | √ | √ | √ |
4.9 短信发送频率
√ 短信验证码
使用同一个签名，对同一个手机号码发送短信验证码，1条/分钟，5条/小时，10条/天。
一个手机号码通过容能云平台只能收到40条/天。
√ 短信通知
使用同一个签名和同一个短信模板ID，对同一个手机号码发送短信通知，支持50条/日（指自然日）
4.10 短信显号规则
手机端接收显示的号码是106开头的正规号码 显号规则：
√ 号码＝通道号＋扩展码；
√ 在通道不稳定、网络抖动及机房断电等不可抗拒的因素下，为确保到达率及到达时间，会自动切换通道，通道号会发生变化。
4.11 短信功能
√ 目前支持短信下行发送、短信状态报告回执、帐单/报表查询等；
√ 短信上行功能目前只支持企业用户申请使用,企业用户如需该功能,请联系官网旺旺:"技术支持",小二会协助您办理.
√ 上行功能免费,但上行产生的通讯费,由运营商向用户收取.
4.12 短信接收异常
√ 手机是不是长时间不关机，可以关机重启下
√ 手机收件箱是不是已满，删除一些看是否可以正常接收
√ 手机是不是双卡双待的手机，把卡拿出来换一下卡槽
√ 手机是不是安装了安全软件，安全软件有可能会进行拦截到垃圾信箱里
√ 如若不行，请您将SIM卡换到其他手机上进行测试。
4.13 短信回执
√ 平台将主动推送短信回执信息给您，
√ 开发者需提供回调地址用于接收容能云推送的短信回执消息；
