2019/1/18 话费券企业客户接入文档语雀话费券企业客户接入文档流程介绍. 充值流程接口说明. 查询充值档位返回可充值档位列表.. 请求参数参数类型是否必填参数说明样例 phone String 必填要充值的手机号

Size: px

Start display at page:

Download "2019/1/18 话费券企业客户接入文档语雀话费券企业客户接入文档流程介绍. 充值流程接口说明. 查询充值档位返回可充值档位列表.. 请求参数参数类型是否必填参数说明样例 phone String 必填要充值的手机号"

折党
4 years ago
Views:

1 话费券企业客户接入文档流程介绍. 充值流程接口说明. 查询充值档位返回可充值档位列表.. 请求参数参数类型是否必填参数说明样例 phone String 必填要充值的手机号 1/12

2 p g 必填要充值的手机号.. 返回结果参数类型是否必填参数说明样例 requestid String 必填请求 ID, 每一个请求都会生成唯一的请求 ID code String 必填 OK 标识请求成功, 可以获取业务数据, 其他标识请求失败需要重试 message String 必填请求失败原因服务不存在 gradelist List<Grade> 必填充值档位列表 OK Grade 结构参数类型示例说明 grade String 档位 vendor String 中国移动所属运营商 price String. 售价 ( 单位 : 元, 保留位 ) channeltype String 全国 / 分省通道类型.. 代码示例 2/12

3 static IAcsClient client = null; public static void init() throws ClientException { 00"); 0"); System.setProperty("sun.net.client.defaultConnectTimeout", "100 System.setProperty("sun.net.client.defaultReadTimeout", "1000 // 产品名称 final String product = "Dycdpapi"; // 域 final String domain = "dycdpapi.aliyuncs.com"; // 初始化客户端 IClientProfile profile = DefaultProfile.getProfile("cn-hangzho u", "your access key", "your access security"); t, domain); DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", produc client = new DefaultAcsClient(profile); public static void main(string[] args) { init(); QueryHfqGradeRequest request = new QueryHfqGradeRequest(); request.setphone(" "); try { QueryHfqGradeResponse acsresponse = client.getacsresponse(r equest); System.out.println(acsResponse.getCode()); System.out.println(acsResponse.getMessage()); if ("OK".equals(acsResponse.getCode())) { QueryHfqGradeResponse result = acsresponse.getayflowclo udorderqueryresponse(); System.out.println(acsResponse.getGradeList()); catch (ClientException e) { e.printstacktrace(); 3/12

4 . 创建订单企业客户通过阿里云 SDK 调用该接口, 进行充值下单.. 接口入参说明参数类型是否必填说明样例 phone String( ) 必填手机号 grade Long 必填充值档位 outorderid String( ) 必填外部订单号, 用来查询结果用, 同一个订单号多次请求的结果是一样的订单号最大长度 tborderid String 非必填天猫订单号, 如果是天猫订单必填 paramlist String 非必填扩展参数, 如果用分省货源, 提供 ( 按照样例 ); 全国货源不需要提供 { "isprovince":tr ue.. 返回结果说明 4/12

5 参数类型是否必填参数说明样例 requestid String 必填请求 ID, 每一个请求都会生成唯一的请求 ID code String 必填 OK 标识请求成功, 可以获取业务数据若非 OK 则可以理解为超时, 需要重试 message String 必填请求失败原因服务不存在 derresponse derresponse.re sultcode derresponse.r esultmsg derresponse.or derid Struct 必填 String 必填代表下单成功, 代表重复订购, 其他代表下单失败详见结果编码章节 String 非必填失败原因系统异常 String 非必填流量云平台订单号当 resultcode 为或时, 该值必填 OK.. 代码样例 5/12

6 static IAcsClient client = null; public static void init() throws ClientException { 00"); ); System.setProperty("sun.net.client.defaultConnectTimeout", "100 System.setProperty("sun.net.client.defaultReadTimeout", "10000" // 产品名称 final String product = "Dycdpapi"; // 域 final String domain = "dycdpapi.aliyuncs.com"; // 初始化客户端 IClientProfile profile = DefaultProfile.getProfile("cn-hangzho u", "your access key", "your access security"); t, domain); DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", produc client = new DefaultAcsClient(profile); public static void main(string[] args) { init(); CreateHfqOrderRequest request = new CreateHfqOrderRequest(); request.setoutorderid(" "); request.setphone(" "); request.setproductid( l); request.settborderid(" "); JSONObject param = new JSONObject(); param.put("isprovince", true); request.setparamlist(param.tostring()); try { CreateHfqOrderResponse acsresponse = client.getacsresponse( request); System.out.println(acsResponse.getCode()); System.out.println(acsResponse.getMessage()); if ("OK".equals(acsResponse.getCode())) { derresponse result = acsresponse.getayflow CloudOrderResponse(); System.out.println(result.getResultCode()); System.out.println(result.getResultMsg()); System.out.println(result.getOrderId()); 6/12

7 果 else { y p ( g ()); // 说明请求超时, 没有拿到结果, 需要用该 outorderid 重试, 获取幂等结 // 或者直接发起查询, 如果查询订单不存在则可按失败处理 // 如果重试获取的 derresponse.code 为或则可标识下单成功 // 表示重复的 outorderid, 说明可能是上次超时的请求已下单成功, 或之前你用过该 outorderid 下过单 // 你自己要保证该 outorderid 的唯一 // 表示下单成功, 之前超时的请求没有成功 catch (ClientException e) { e.printstacktrace();. 充值结果查询企业客户通过阿里云 SDK 调用该接口, 进行充值查询.. 接口入参说明参数类型是否必填说明样例 outorderid String( ) 必填外部订单号, 用来查询结果用, 同一个订单号多次请求的结果是一样的订单号最大长度.. 返回结果说明参数类型是否必填参数说明样例 requestid String 必填请求 ID, 每一个 7/12

8 requestid String 必填请求 ID, 每个请求都会生成唯一的请求 ID code String 必填 OK 标识请求成功, 可以获取业务数据, 其他标识请求失败需要重试 message String 必填请求失败原因服务不存在 derqueryrespo nse derqueryrespo nse.resultcode derqueryrespo nse.resultmsg Struct 必填 String 必填代表充值成功, 代表充值中, 代表订单不存在, 其他代表失败 String 非必填失败原因系统异常 OK derqueryrespo nse.extendpara m String 非必填扩展字段,JSON 格式, 基础运营商充值订单流水号 {"ResponseId": " ".. 代码样例 static IAcsClient client = null; public static void init() throws ClientException { 8/12

9 00"); ); System.setProperty("sun.net.client.defaultConnectTimeout", "100 System.setProperty("sun.net.client.defaultReadTimeout", "10000" // 产品名称 final String product = "Dycdpapi"; // 域 final String domain = "dycdpapi.aliyuncs.com"; // 初始化客户端 IClientProfile profile = DefaultProfile.getProfile("cn-hangzho u", "your access key", "your access security"); t, domain); DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", produc client = new DefaultAcsClient(profile); public static void main(string[] args) { init(); QueryHfqOrderRequest request = new QueryHfqOrderRequest(); request.setoutorderid(" "); try { QueryOrderResponse acsresponse = client.getacsresponse(requ est); System.out.println(acsResponse.getCode()); System.out.println(acsResponse.getMessage()); if ("OK".equals(acsResponse.getCode())) { QueryHfqOrderResponse.derQueryResponse res ult = acsresponse.getderqueryresponse(); System.out.println(result.getResultCode()); System.out.println(result.getResultMsg()); catch (ClientException e) { e.printstacktrace();. 企业客户接收充值回调结果 9/12

10 参考 : spm=a c g.... rkmk < spm=a c g.... rkmk >.html?.html? 签名机制. 需要参与签名的参数在请求参数列表中, 除去 sign 参数外, 其他需要使用到的参数皆是要签名的参数没有值的参数无需传递, 也无需包含到待签名数据中. 生成待签名字符串对于如下的参数数组 :string[] parameters = { outorderid=, phone=, resultcode =, result Msg= 成功, signtype=md ; 对数组里的每一个值从 a 到 z 的顺序排序, 若遇到相同首字母, 则看第二个字母, 以此类推排序完成之后, 再把所有数组值以 & 字符连接起来, 如 : outorderid= &phone= &resultcode = &resultmsg= 成功 &signtype=md, 这串字符串便是待签名字符串注意 : 没有值的参数无需传递, 也无需包含到待签名数据中签名时将字符串转化成字节流时指定 UTF 字符集根据 HTTP 协议要求, 传递参数的值中如果存在特殊字符 ( 如等 ), 那么该值需要做 URL Encoding, 这样请求接收方才能接收到正确的参数值这种情况下, 待签名数据应该是原生值而不是 encoding 之后的值例如 : 调用某接口需要对请求参数进行数字签名, 那么待签名数据应该是 =test@msn.com, 而不是 =test% msn.com < msn.com/>. MD 签名在 MD 签名时, 需要私钥参与签名 MD 的私钥当前需要线下供给技术支持当拿到请求时的待签名字符串后, 需要把私钥直接拼接到待签名字符串后面, 形成新的字符串, 利用 MD 的签名函数对这个新的字符串进行签名运算从而得到位签名结果字符串 ( 该字符串赋值于参数 sign) 如 10/12

11 数对这个新的字符串进行签名运算, 从而得到位签名结果字符串 ( 该字符串赋值于参数 sign) 如私钥为 :abcdefgha 签名串明文为 : outorderid=kaidi &phone= &resultcode= &result Msg= 成功签名为 :signtype=md &sign=be eb b a c ac b ec e 附录. 结果编码结果编码说明充值下单接口中代表下单成功充值结果回调接口充值结果查询接口中代表充值成功充值中 ( 查询接口中有效 ) 充值订单不存在 ( 查询接口中有效 ) 未支付订单数量超限无效的产品 ID 无效的手机号手机号运营商和订购商品不匹配无可用同通道预扣失败未支付订单超限手机号归属地和订购商品不匹配系统繁忙, 请重试 11/12

12 12/12

2019/1/18 供应商接入流量云平台接口规范语雀供应商接入流量云平台接口规范. 文档说明. 功能说明本协议规定了合作方接入流量云平台的流程和接口规范, 用于合作方开发接口完成流量 / 话费充值业务流程图如下 :. 阅读对象面向具有一定的网站开发能力, 了解 ASP PHP JAVA A

2019/1/18 供应商接入流量云平台接口规范语雀供应商接入流量云平台接口规范. 文档说明. 功能说明本协议规定了合作方接入流量云平台的流程和接口规范, 用于合作方开发接口完成流量 / 话费充值业务流程图如下 :. 阅读对象面向具有一定的网站开发能力, 了解 ASP PHP JAVA A 供应商接入流量云平台接口规范. 文档说明. 功能说明本协议规定了合作方接入流量云平台的流程和接口规范, 用于合作方开发接口完成流量 / 话费充值业务流程图如下 :. 阅读对象面向具有一定的网站开发能力, 了解 ASP PHP JAVA ASP.NET 等开发语言中的一种及 SQL 数据库语言的网站开发维护和管理人员. 接口定义约定采用 http 协议,get 方式提交请求, 字符编码格式为

2019/1/18 话费券企业客户接入文档 语雀 话费券企业客户接入文档 流程介绍. 充值流程 接口说明. 查询充值档位 返回可充值档位列表.. 请求参数 参数 类型 是否必填 参数说明 样例 phone String 必填 要充值的手机号

2019/1/18 话费券企业客户接入文档语雀话费券企业客户接入文档流程介绍. 充值流程接口说明. 查询充值档位返回可充值档位列表.. 请求参数参数类型是否必填参数说明样例 phone String 必填要充值的手机号