《API接口调用说明及示例第四次修订.docx》由会员分享，可在线阅读，更多相关《API接口调用说明及示例第四次修订.docx（18页珍藏版）》请在三一办公上搜索。
1、产品顽目名称保留级别邮件系统机密产品;1页目版本最终更新日期81032014-09-12邮件系统V8接口文档1僚亿中印信息技术有限公司版权全部侵权必究仅供内部运用修订记录日期修订版本修改描述作者2012-11-150.1初稿刘畅2013-10-210.2初稿王永杰2014-04-220.3更新错误的5值傅春花2014-09-120.4*S三整理文档周盈妤1接口简介未指定书签.2认证财-g!未指定书签.2.1 认iEM分类未指定书签.2.2 认防式的腼-躯!未指定书签.2.3 iuHJS三!未指定书签.3认证方法详解及示例-错误!未指定书签.3.1 错误!未指定书签.3.2 躯!未指定书签。3.
2、2.1 的认证方法：IB误!未指定书签.3.2.2 的认证方法：-错误!未指定书签。3.2.3 申35i三:未指定书签.4接口调用示例-错误!未指定书签。4.2调用!未指定书签.4.2.1 资源螃-附!未指定书签.4.2.2 以用户的熠制改宜为例，示例各种调I用步骤错误!未指定书签.5附表-蹒!未指定书签.1接口简介指邮件系统所供应的接口.调用接口流程图：为了保证调用的平安性等因素，要求园用方必需持有.此须要由调用方向方申请此.方在接受调用方申请后,会颁发以及一个与之配对的.调用方必需记录此以及,是供应方（例如部署了由M牛系统的单位）颁发给调用方（例如须要获得邮件系统数据的系统）的身份识别串.
3、此事一个郃件地址格式的字符串，例如：供应方颁发给调用方身份识别串对应的秘钥。此是一个32字节的字符串，例如35c51333dle9b36802c5d79b8.接口分为两大类：（1）用户供应（单点登录）的.（2）用于邮件资源操作的.2认证概述为保证的平安性，防止非法的调用.识另腿用者身份的合法性，在调用过程中必需先进行认证。2.1 认证方式的分类支持三种认证方式，分别是、和方式.是符合规范的凉准认证方式，而和是自定义的规范。2.2 认证方式的选择由于认证方式比较困难，所以不建议运用认证方式，除非您的业务必须要求通循方式认证.比平安性更高,但是也会更困难一些,须要先申请会话.钱如您对调用的平安性要
4、求较高，那么建议您运用认证方式.假如您对调用的平安性要求不是特别高（比如部件系统部署在内网，只在内网运用），刃必可以运用认证方式。2.3 认证原理认证的原理是：调用方在调用的同时须要附加传递认证信息（、签名等），在接收到调用恳求的同时，首先获得认证信息并进行认证，假如认证失败剜给出错误提示，假如认证胜利则按蓿处理调用恳求，之后返回处理结果。不同的认证方式传递的认证信息有所不同,有的认证方式还须要湖得一些其他的平安认证数据用来生成认证信息，例如认证方式须要先申请会话.3认证方法详解及示例3.1标准的认证方式,详见官方文档以及5849.3.2认证方式对于和两种接口稍有不同,传递认证信息是通过的方式
5、，则是通过把认证信息参数放到的头中传递.3.2.1 的认证方法：格如下表格中的参数以参数的形式传递给.留意：由于是通过方式传递认证信息参数，所以全部的参数的值都必须要进行处理.参数名参数说明认证方定为固定的伯.系统当前的整数时间St会话,此会话须要在调用之前申湾.申请方法见申请会话.签名.JS法：5(+)的目标用户的邮件地址.此整数并不是认证信息参数,但是由于在计算签名的时候须要用到，所以这这里列出.的认证完整硒保设如下音数的佰为：:3551333dle9b36802c5d79b8申谓到的会话：548系统当前的整数时间截1262307600计舞签名：计算的结果：46a8f7621e86811d
6、7b2260339bl此时得到方式传送所需的五个卷数：12623076;：548;:468f7621e86811d7b2260339bl;对五个参数分别作处理,得到如下结果：40；:1262307600;:S483D;:46a8f76c21e86811d7b2260339bl;那么的思来为：3.2.2 的认证方法：将如下表格中的卷数放到的头中传递给,（的认证中，签名的计算不须要，此处与不留意：由于是通过头方式传递认证信息?所以全部的参:都必须要进行处理.参数名参数说明认证方式.为固定的S.系统当前的整数时间战会话.此会话须要在魂用之前申请.申谓方法见申请会话.签名.算法：5(+)的认证完整初保
7、设如下段数的佰为:3551333dle9b368O2c5d79b8申请到的会话：548系统当前的整数时间彼12623076计算签名：计算旌果：3e7fOe9a79c5Hla67d7499O8a3牝时到头中传送所需的五个图数：1262307600;:S48;:3e7fOe9a79c51fla67d749908a3;对五个参数分别作处理,得到如下结果：40;:1262307600;：5483D：3e7f0e9a79c51fla67d749908a3;那么(以轶得的未注邮件数也为例)的总求数据包为：4011.0：,40,1262307600,5483D-.3e7f0e9a79c51fla67d749
8、908a3在认证方式中，和都须要提前申请用于传参和计算签名，申请会话的恳求为:申请会话须要向上述发送一个为的恳求，此恳求必需包含如下表格中的参数.留意：由于是通过头方式传递认证信息参数厮以全部的参数的值都必须要进行处理.参数名参数说明系统当前的整数时间St三.管法：5（+）（非必需）的目标用户的邮件地址.（时须要此叁数，不须要）上表中的前三个卷数必需传递，除了必需传递的参数之外，还可以附加传递其它附加参数,全部的附加参数都会被记录在邮件系统中，以供下一步的验证运用（例如要求必需传递一个附加参数）,但是要出意，附加的参数名不能以开头，以防止和必需传递的参数冲突.假如申请胜利，会话将会被放到恳求的
9、应答中输出.胜利或者失败的应答及说明详见附表1.获得完整示例假设如下整数的值为：:35,=$,=5(.$),)；$(.)；$0；S(三);$,=)；$0；$三$();荻得到会话认证传递认证信息是把认证信息参数放至购头中传递.认证信息螟包含,，.其中签名的想法为：5(+)$=5(.$.$)；获得签名$=(=.=$.系疑当前的找数时诃战=$,会话=$,密名)；$=0；(SSSv)$0=Sk.=.(Sv).；：由于是通过头方式传递认Sl,所以锚的参数的他航颁要进行处理.)$=得到认证/,例如S的输出结果为:MO-.1262307600，,5483D,3e7f0e9a79c51fla67d749908
10、a37(添加新用户方法S=T；$=1；$=,100100100,;$=,.,；依酶口的EW依受接口的患求方式设置恳求方法$($);$(r=$);在头拿传递认证信息$0；S0;JSS200ItSK利,陆帕2S0;.由.)（获得用户信息方法（资谀详情臭兔）$=1；$（.$.$）；a三接口的患求设，$0；依据接口的总求方式iSJB求方法在头部传递认证信息-=.获组资源详情类空）；$0；$o；,2oo,tmm,*fw三2S0;酥蹄SEl用，S3,失败时撞示镯n岫.（获得用户列表方法（凌源列表类型）$（.$.）；依一口的聂求设$o；依雌口的sc法在头部传递认证颉决得资源列表类型$0：$0;200,ftK
11、n.附表2$o；胜利时返回用户列米,失败时提示能海e.）（修改用户信息方法$-200;$=1;$=.,；S(.-.依交接口的燃求设$0；依砌口的易求方式设恩求方法$(r=$)；在头S5传递认证信息$(5);$0：$0；期200代表胜利,JS答代码列表参考台250；胜利时返回空，若失败返回棒误际)(附除组方法$=,1;$;依报口的J0求设，$();三口的息求方式设黛悬求方法$”=$;在头部传递认证信息$0；$0；返回20Q代表胜利，应答代码列表程卿场2$0；胜利时返回空，告尔收返回锦误提示.)5附表附表1：申请时应答代码说明返回代码说明200申请胜利改少必要的暂数.400级J格式错谀，缘数长度超出限制，必需小于5.401签名蛤证错读500系统内部错误附表2:调用认证结果的应答代码说明返回代码说明200认证并且Sffl用胜?山改少必要的暂数.400卷的格式IS误.缘数长度超出限制，必需小于5.401签名蛤证错读SOO系统内部错误
