1 应用接入配置表

能力配置项说明
短信能力短信签名用于发送短信,若要使用短信能力,必须设置,并且需要经过审核
短信模板1、系统短信模板不需要进行审核
2、自定义短信模板需要进行审核才能使用
每天短信上限设置限制每天短信发送数量,默认不限制
短信发送报告回调地址设置短信发送报告回调地址,用于容能云将短信发送结果回调给应用服务器
流量能力流量开关开启使用流量能力的开关,开启后才能正式使用流量能力
流量押金需要缴交10000的流量押金后,才能使用流量能力
流量回调地址用于容能云讲流量充值结果回调给应用服务器


2 用户能力接入

2.1 托管用户鉴权

√  托管用户直接集成Android或iOS的sdk。用户发起访问后,sdk自动请求容能云的用户能力。

√  托管用户鉴权通讯架构图


                        20170802152009.png

2.2 非托管用户鉴权

2.2.1 非托管用户鉴权通讯架构图


                        20170802152511.png

2.2.2 获取token

√  接口地址

接口地址https://i.ipower.cn/a/appServerJson/loginIn
请求方式post
数据类型json


√  请求参数

参数名称参数类型参数说明
userIdString应用用户id

    json 请求示例

{
    "userId"   : "14fa47d8e7e041b48fe25565a87ff02d"
}

√  响应参数

参数名称参数类型参数说明
resultCodeString响应编码
msgString响应消息
verifyrandom响应随机数,6位随机数
time响应时间,单位毫秒
signature响应签名
datarequestNoString请求号
tokenString返回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

√  请求参数

参数名称参数类型参数说明
userIdString应用用户id

json请求示例

{
    "userId"   : "14fa47d8e7e041b48fe25565a87ff02d"
}

√  响应参数

参数名称参数类型参数说明
resultCodeString响应编码
msgString响应消息
verifyrandom响应随机数,6位随机数
time响应时间,单位毫秒
signature响应签名
dataobject返回数据

json响应示例

{
    "resultCode": "1000",
    " msg ": "移除token成功",
    "verify": {
        "random": "806274",
        "time": "1500532397",
        " signature": "7a308a0b3d16fa58a3f6cf0326f369933253de68",
        
    },
    "data": {
        
    }
}


3 流量能力接入

3.1 流量能力接入流程图

                        1496926108111766.png


3.2 流量能力配置参数

能力配置项说明
流量能力流量开关开启使用流量能力的开关,开启后才能正式使用流量能力
流量押金流量能力需要缴交流量押金后使用
流量回调地址用于容能云将流量充值结果回调给应用服务器


3.3 运营商的流量套餐表

流量套餐表下载:流量包套餐.xlsx

移动(单位:M)电信(单位:M)联通(单位:M)
──5──
1010──
────20
303030
505050
70────
100100100
──200200
150────
300──300
500500500
102410241024
2048────


3.4 流量能力接入审核

√  审核周期:预计3个工作日

√  申请提交的资料:营业执照副本, 税务登记证副本, 组织机构代码证副本, 一般纳税人证


3.5 平台流量钱包套餐充值

支持运营商省内流量全国流量有效期到账时间充值频率充值限制
中国移动当月有效24小时内无限制月末最后二天不能充值
中国电信当月有效24小时内无限制月初第一天和月末最后一天不能充值
中国联通当月有效24小时内无限制月末最后一天不能充值


3.6 流量能力接入文档

流量能力接入文档V1.0.pdf

4 短信能力接入

4.1 短信能力接入流程图

                        1496925156584672.png


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 短信模板审核流程

image.png


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 短信回执

√  平台将主动推送短信回执信息给您,

√  开发者需提供回调地址用于接收容能云推送的短信回执消息;


4.14 短信能力接入文档

短信能力接入文档V1.0.pdf