湖南电信---流量后向经营服务接口协议-NEW.docx

中国电信综合平台流量后向经营平台接口协议V1.0中国电信综合平台开发运营中心序号主要更改内容版本号操作操作人操作时间13.1定向流量包订购接口V1.0新增李柏2014/05/2923.2回调接口V1.0新增李柏2014/05/291概要本文档提供了通过综合平台订购流量包的依据。2接口说明接口方式HTTP输入标准标准JSON格式输出标准标准JSON格式参数加密接口使用AES进行参数加密，加密模式为AES-128-CBC，密钥key和向量iv都为16位，由综合平台提供，只需要对code参数值加密即可。注意：AES加密生成二进制加密串后，还需转为十六进制加密串,代码如下：public static String encodeBytes(byte bytes) StringBuffer strBuf = new StringBuffer();for (int i = 0; i 4) & 0xF) + (int) a);strBuf.append(char) (bytesi) & 0xF) + (int) a);return strBuf.toString();参数样例：加密前：“partner_no”:”100054374”,”code”:”request_no:1000000004,service_code:FS0001,channel_id:1,contract_id:FBMP20140106001,order_id:0,activity_id:100005,phone_id:18022887432,plat_offer_id:100051”加密后：partner_no:100054374,code:liecbgnmmijljjfheboikdlfhdmedijfnikampopobcgmfdncmkbblepgmhllplpgkhocficobiefdffbjichalnninllhmdflnooboomfmmcfomjjnafadplokhejgciflgbnockcicmdlbacphofnkkgpkelahohmcmjlaeedhfljadbiafclklfdhbkojgeeebedlfedfjhjpobajopdilpkbcoddongkfmjnlkepcdgddliibknmlcifolfjiahonkmmgginipgikmffkdabkgfooahacfbeffbojkjfjajdefckeogbbahdjknhdpoobckpbmkjpdjgkhiobookjojhlnebhiemekngmakalefcihkgadgimdaadbhg3接口3.1.定向流量包订购/退订接口综合平台接收到合作方订购/退订流量包的请求，处理完成后异步通知合作方订购结果。3.1.1.接口概述接口名称定向流量包订购接口服务编码FS0001处理方式异步功能描述3.1.2.输入参数属性名称属性编码约束描述备注合作方IDpartner_nonot null合作方唯一标识平台分配请求流水号request_nonot null（length30）请求流水号，合作方生成，长度小于30服务编码service_codenot null识别接口平台分配合同IDcontract_idnot null合同唯一标识平台分配订单IDorder_idnot null订单唯一标识固定为0销售品IDplat_offer_idnot null流量包ID平台分配销售品价格price销售品价格,可不传单位：分手机号码phone_idnot null手机号码活动IDactivity_idnot null活动ID平台分配订购类型order_typenot null1：订购；2：退订渠道IDchannel_idnot null渠道标识（见附录4.2）平台分配 输入样例（加密前）：“partner_no”:”100001186”,“code”:”request_no”:”123”,” service_code”:” FS0003”,”contract_id”:”100001”,”order_id”:”0”,”plat_offer_id”:”100001”,”price”:”500”,”phone_id”:”18911111111”,”activity_id”:”98273”,”order_type”:”1”,”channel_id”:”1” ”3.1.3.输出参数属性名称属性编码描述请求编号request_no原值返回请求流水号返回编码result_code返回编码(见附录4.1) 输出样例： “request_no”:”123”,“result_code”:” 00000”3.2回调接口综合平台订购完成流量包后，通知合作方订购结果。3.2.1回调地址格式接口方式格式HTTPhttp:/xxxxx/xxxxx.do(合作方提供)3.2.2.输入参数属性名称属性编码描述请求编号request_no原值返回请求流水号返回编码result_code返回编码(见附录4.1) 输入样例（加密前）：“request_no”:”123”,“result_code”:” 00000” 3.2.3.输出参数属性名称属性值描述返回值1判断合作方是否接收到订购结果，固定返回1。4.附录4.1返回结果编码表结果编码描述00000成功10001非法手机号码10002非法批次10003非法参数(参数只能是特殊字符或为空值)10004非法订购日期10005签名验证失败10006非法合作方10007非法销售品10008非法请求流水号10009非法渠道10010号码欠费10015客户未订购该套餐10016客户已订购该套餐10026生成订单号失败10027超出可订购流量包的数量10028活动尚未开始10029活动任务已结束10030非法合同编号10033用户有在途工单，无法受理10040无权限调用该服务10043无权限访问该接口10054在同一销售品组A下，能且仅能受理一款销售品10055产品未配置10056营销资源未配置10057号码归属地信息不正确10108用户为预开通卡用户，请先办理资料返档90002CRM内部错误99999其他错误4.2.渠道编码表渠道编码渠道描述1Web2wap3android4ios8platform