©2010-2025 宁波自信网络信息技术有限公司 版权所有
客服电话：4009-655-100 投诉/维权电话：18658249818
浙ICP备2021020529号-1 | 浙B2-20240490
关注我们 ：
1、 中国电信综合平台 流量后向经营平台接口协议V1.0 中国电信综合平台开发运营中心 序号 主要更改内容 版本号 操作 操作人 操作时间 1 3.1定向流量包订购接口 V1.0 新增 李柏 2014/05/29 2 3.2回调接口 V1.0 新增 李柏 2014/05/29 1．概要 本文档提供了通过综合平台订购流量包的依据。
2、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
3、) { 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","contra
4、ct_id":"FBMP20140106001","order_id":"0","activity_id":"100005","phone_id":"18022887432","plat_offer_id":"100051"}” } 加密后： {"partner_no":"100054374", "code":"liecbgnmmijljjfheboikdlfhdmedijfnikampopobcgmfdncmkbblepgmhllplpgkhocficobiefdffbjichalnninllhmdflnooboomfmmcfomjjnafadplokhejgciflgbnockci
5、cmdlbacphofnkkgpkelahohmcmjlaeedhfljadbiafclklfdhbkojgeeebedlfedfjhjpobajopdilpkbcoddongkfmjnlkepcdgddliibknmlcifolfjiahonkmmgginipgikmffkdabkgfooahacfbeffbojkjfjajdefckeogbbahdjknhdpoobckpbmkjpdjgkhiobookjojhlnebhiemekngmakalefcihkgadgimdaadbhg" } 3．接口 3.1.定向流量包订购/退订接口 综合平台接收到合作方订购/退订流量包的请求
6、处理完成后异步通知合作方订购结果。 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 合同唯一
7、标识 平台分配 订单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） 平台分配 Ø 输入
8、样例（加密前）： { “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.输出参数 属性名称 属性编码 描述 请求编号
9、 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
10、1) Ø 输入样例（加密前）： { “request_no”:”123”, “result_code”:” 00000” } 3.2.3.输出参数 属性名称 属性值 描述 返回值 1 判断合作方是否接收到订购结果，固定返回1。 4.附录 4.1返回结果编码表 结果编码 描述 00000 成功 10001 非法手机号码 10002 非法批次 10003 非法参数(参数只能是特殊字符或为空值) 10004 非法订购日期 10005 签名验证失败 10006 非法合作方 10007 非法销售品 10008 非法请
11、求流水号 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
©2010-2025 宁波自信网络信息技术有限公司 版权所有
客服电话：4009-655-100 投诉/维权电话：18658249818
浙ICP备2021020529号-1 | 浙B2-20240490
关注我们 ：
