全部产品
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
流量服务

定向流量订购接口(OrderFlow)

更新时间:2017-10-09 17:03:10

定向流量订购接口(OrderFlow)

定向流量整体流程及操作步骤

定向流量整体流程及操作步骤

参数说明

入参列表
参数名称 参数类型 必填与否 样例取值 参数说明
PhoneNumber String 必填 13010112022 订购手机号
Grade String 必填 1 订购档位ID ,详见定向流量价格表
TransferId String 必填 20170901123456001 外部订单号,用来做幂等校验,也可根据此单号查询订购状态
出参列表
出参名称 出参类型 样例取值 参数说明
RequestId String 8906582E-6722 请求ID
Code String OK 状态码-返回OK代表请求成功,其他错误码详见错误码列表
Message String 请求成功 状态码的描述

技术对接步骤

1:下载SDK工具包

SDK工具包中一共包含了2个类库,一个aliyun-java-sdk-core包,另外一个是alicom-dycdp-api包,将这两个包执行mvn package命令或者mvn deploy命令打包出相应的jar包,添加到工程类库中依赖使用。

SDK&DEMO[下载地址]

2: 编写样例程序
  1. //设置访问超时时间
  2. System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
  3. System.setProperty("sun.net.client.defaultReadTimeout", "10000");
  4. //云通信产品-流量服务API产品名称
  5. final String product = "Dycdpapi";
  6. //云通信产品-流量服务API产品域名
  7. final String domain = "dycdpapi.aliyuncs.com";
  8. //需要替换成你的AK信息
  9. final String accessKeyId = "yourAccessKeyId";
  10. final String accessKeySecret = "yourAccessKeySecret";
  11. //初始化acsClient
  12. IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessKeyId, accessKeySecret);
  13. DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", product, domain);
  14. IAcsClient acsClient = new DefaultAcsClient(profile);
  15. //组装请求对象
  16. OrderFlowRequest request = new OrderFlowRequest();
  17. //订购的号码
  18. request.setPhoneNumber("1300000000");
  19. //订购的档位
  20. request.setGrade("1");
  21. //外部订单号
  22. request.setTransferId("20170901123456001");
  23. //请求失败这里会抛异常
  24. OrderFlowResponse acsResponse = acsClient.getAcsResponse(request);
  25. if(acsResponse.getCode()!= null && acsResponse.getCode().equals("OK")) {
  26. //请求成功
  27. }

错误码列表

Code 描述
OK 请求成功
isp.DXLL_NOT_INVITED 客户未参与定向流量邀约
isv.DXLL_NOT_VALID_GRADE 定向流量档位不可用
isv.UNKNOWN 未知异常
isv.DXLL_ORDER_PROCESSING_CONFLICT 有在途订单
isv.DXLL_NOT_SID_INFO 定向流量免流id不存在
isv.MOBILE_NUMBER_ILLEGAL 手机号码格式错误
isv.RES_OWNER_ID_UNKNOWN 找不到资源归属的阿里云ID
isv.PRODUCT_UN_SUBSCRIPT 未开通云通信产品的阿里云客户
isv.SYSTEM_ERROR 接入层系统异常
本文导读目录