《流量管理平台对外接口》由会员分享,可在线阅读,更多相关《流量管理平台对外接口(5页珍藏版)》请在金锄头文库上搜索。
1、 北京亿美软通科技有限公司 地址: 北京市朝阳区通惠河畔文化创意产业园 电话:010-58750575 传真:010 售前咨询:400-810-7255 售后服务:流量管理平台用用 作 者: 北京亿美完成日期: 签 收 人: 签收日期: 修改情况记录: 版本号 修改批准人通惠河畔文化创意产业园 1131 号君天大厦六层(100023) 10-58750500 网址: :400-779-7255 案案卷卷号号 日日期期 平台对外接口(HTTP 版) 户户 手手 册册 北京亿美软通科技有限公司 2015-4-23 修改批准人 修改人 安装日期 签收人 北京亿美软通科技有限公司 地址: 北京市朝阳区
2、通惠河畔文化创意产业园 电话:010-58750575 传真:010 售前咨询:400-810-7255 售后服务:1 1 流流量量管管理理平平台台开开发发说说明明1 1. .1 1 简简介介 流量管理平台是为企业客户提供1 1. .2 2 背背景景 系系统统名名称称:流量管理平台 项项目目开开发发者者: 北京亿美软通科技有限公司2 2 接接口口说说明明 2 2. .1 1 H Ht tt tp p 接接口口说说明明: : 2.1.1 接口地址: 地址:http:/123.57.210.65:80/outerservice/request2.1.2 参数说明: 参数 key 发送信息的 MD5
3、 码 value 对发送信息进行加密appId 我方提供给您的 AppId2.1.3 具具体体参参数数说说明明 通惠河畔文化创意产业园 1131 号君天大厦六层(100023) 10-58750500 网址: :400-779-7255 流流量量管管理理平平台台开开发发说说明明 为企业客户提供“流量赠送”功能,打造一站式移动互联网化服务北京亿美软通科技有限公司 http:/123.57.210.65:80/outerservice/request 描 述 生成方式及加密方式对 mobiles=mobiles&ctcc=ctcc&c ucc=cucc&cmcc=cmcc&etype=etype进
4、行 MD5 加密生成对发送信息进行加密 对 mobiles=mobiles&ctcc=ctcc&c ucc=cucc&cmcc=cmcc& 先进行 AES 加密 结果进行 base64AppId appId 打造一站式移动互联网化服务。 生成方式及加密方式 mobiles=mobiles&ctcc=ctcc&c ucc=cucc&cmcc=cmcc&etype=etype 加密生成 key mobiles=mobiles&ctcc=ctcc&c ucc=cucc&cmcc=cmcc&etype=etype 加密,再对 AES 加密的 base64 生成 value 北京亿美软通科技有限公司 地
5、址: 北京市朝阳区通惠河畔文化创意产业园 电话:010-58750575 传真:010 售前咨询:400-810-7255 售后服务:参数 mobiles 手机号列表,ctcc 电信套餐编号cucc 联通套餐编号cmcc 移动套餐编号etype 生效类型, 0-立即生效 分运营商可能不支持token 分配给您的准入appId 分配给您的准入备注:联通、移动、电信套餐至少要一个不为空 把这些号码认为是错误号码处理。 2.1.4 返返回回值值 返回值为 json 格式,示例如下 “code“:“E0001“, “msg“:“拒绝访问“, “batchNo“:“3028402934283“, “er
6、rorMobiles“:“123“,“234“,“mobileNumber“:10 2.1.5 请请求求方方式式 http 请求方式为 Post 方式。 2 2. .2 2 回回调调接接口口 H Ht tt tp p 接接口口说说明明: : 第三方需要提供一个 http 回调接口,2.2.1 接口地址 地址由第三方提供给我司 通惠河畔文化创意产业园 1131 号君天大厦六层(100023) 10-58750500 网址: :400-779-7255 描 述 是否必输项,最多支持 50 个 是 电信套餐编号,根据提供套餐列表选择 否 联通套餐编号,根据提供套餐列表选择 否 移动套餐编号,根据提供
7、套餐列表选择 否 立即生效, 1-下月生效 (部 分运营商可能不支持) 否 分配给您的准入 TOKEN,用于加密 是 分配给您的准入 APPID,用于识别用户 是 电信套餐至少要一个不为空,如果套餐为空而且号码列表存在该类型的号码我们将会示例如下: /状态码 /错误信息,成功的话,此处为空 /批次号,我方返回的批次号,回调以此为准“errorMobiles“:“123“,“234“, /错误号码,检测到提供的错误不能处理的号码/处理的号码总数 ,当批次号码执行完成时调用接口通知发送结果是否必输项 如果套餐为空而且号码列表存在该类型的号码我们将会回调以此为准 检测到提供的错误不能处理的号码 当批
8、次号码执行完成时调用接口通知发送结果。 北京亿美软通科技有限公司 地址: 北京市朝阳区通惠河畔文化创意产业园 电话:010-58750575 传真:010 售前咨询:400-810-7255 售后服务:2.2.2 参数说明 参数 data 批次号码情况 及数据 Data 为 json 格式,示例如下 “batchNo“:“xxxxxxx“, “successCount“:1, “failCount“:2, “errorlist“: “mobile“:“15563736374“,“code“:“N0001“ , “mobile“:“15563736372“,“code“:“N0003“ , “m
9、obile“:“15563736373“,“code“:“N0002“ 2.2.3 返返回回值值 必须给我们返回一个 SUCCESS。 2.2.4 请请求求方方式式 http 请求方式为 Post 方式。 通惠河畔文化创意产业园 1131 号君天大厦六层(100023) 10-58750500 网址: :400-779-7255 描 述 是否必输项批次号码情况,返回成功、失败条数以是 : /批次号 /成功数量 /失败数量 /号码列表 “mobile“:“15563736374“, /手机号 /状态码 “mobile“:“15563736372“, “mobile“:“15563736373“,
10、 是否必输项 北京亿美软通科技有限公司 地址: 北京市朝阳区通惠河畔文化创意产业园 电话:010-58750575 传真:010 售前咨询:400-810-7255 售后服务:3 3 代代码码描描述述说说明明 ? 即即时时返返回回的的信信息息 代码 M0001 M0002 M0003 M0004 M0005 M0006 M0007 M0008 M0009 M9999 ? 回回调调,单单个个原原因因 代码 N0001 N0002 N0003 4 4. .示示例例代代码码 dem o. zi p5 5. .套套餐餐列列表表 具体套餐列表会随时更新,请及时向我通惠河畔文化创意产业园 1131 号君天大厦六层(100023) 10-58750500 网址: :400-779-7255 描述 成成功功 无法解析请求错误 套餐选择错误 IP 未注册错误 APPID 不识别错误 解密校验失败错误 余额不足错误 无可用号码错误 请求被拒绝错误 其他错误 描述 成成功功 运营商方面异常 系统异常 请及时向我方接口人获取。