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

中国电信综合平台 流量后向经营平台接口协议V1.0 中国电信综合平台开发运营中心 序号 主要更改内容 版本号 操作 操作人 操作时间 1 3.1定向流量包订购接口 V1.0 新增 李柏 2014/05/29 2 3.2回调接口 V1.0 新增 李柏 2014/05/29 1．概要 本文档提供了通过综合平台订购流量包的依据。 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 bytes.length; i++) { strBuf.append((char) (((bytes[i] 4) 0xF) + ((int) a))); strBuf.append((char) (((bytes[i]) 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_idplat_offer_id:100051}” } 加密后： {partner_no:100054374, code:liecbgnmmijljjfheboikdlfhdmedijfnikampopobcgmfdncmkbblepgmhllplpgkhocficobiefdffbjichalnninllhmdflnooboomfmmcfomjjnafadplokhejgciflgbnockcicmdlbacphofnkkgpkelahohmcmjlaeedhfljadbiafclklfdhbkojgeeebedlfedfjhjpobajopdilpkbcoddongkfmjnlkepcdgddliibknmlcifolfjiahonkmmgginipgikmffkdabkgfooahacfbeffbojkjfjajdefckeogbbahdjknhdpoobckpbmkjpdjgkhiobookjojhlnebhiemekngmakalefcihkgadgimdaadbhg } 3．接口 3.1.定向流量包订购/退订接口 综合平台接收到合作方订购/退订流量包的请求，处理完成后异步通知合作方订购结果。 3.1.1.接口概述 接口名称 定向流量包订购接口 服务编码 FS0001 处理方式 异步 功能描述 3.1.2.输入参数 属性名称 属性编码 约束 描述 备注 合作方ID partner_no not null 合作方唯一标识 平台分配 请求流水号 request_no not null（length30） 请求流水号，合作方生成，长度小于30 服务编码 service_code not null 识别接口 平台分配 合同ID contract_id not null 合同唯一标识 平台分配 订单ID order_id not null 订单唯一标识 固定为0 销售品ID plat_offer_id not null 流量包ID 平台分配 销售品价格 price 销售品价格,可不传 单位：分 手机号码 phone_id not null 手机号码 活动ID activity_id not null 活动ID 平台分配 订购类型 order_type not null 1：订购；2：退订 渠道ID channel_id not 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”:,”