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

资源描述

中国电信综合平台流量后向经营平台接口协议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_id":"18022887432","plat_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（length<30）请求流水号，合作方生成，长度小于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”:”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回调地址格式接口方式格式 HTTP http://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 用户为预开通卡用户，请先办理资料返档 90002 CRM内部错误 99999 其他错误 4.2.渠道编码表渠道编码渠道描述 1 Web 2 wap 3 android 4 ios 8 platform

展开阅读全文