开发者社区 问答 正文

php如何预校验接口(PreCheckOrder)



预校验接口(PreCheckOrder)



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


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

参数说明



入参列表

参数名称参数类型必填与否样例取值参数说明
PhoneNumberString必填13010112022订购手机号
GradeString必填1订购档位ID ,详见定向流量价格表


出参列表

出参名称出参类型样例取值参数说明
RequestIdString8906582E-6722请求ID
CodeStringOK状态码-返回OK代表请求成功,其他错误码详见错误码列表
MessageString请求成功状态码的描述


技术对接步骤



1:下载SDK工具包


SDK工具包中一共包含了2个类库,一个aliyun-php-sdk-core包,另外一个是alicom-dycdp-api包,将这两个包添加到工程依赖中。
SDK&DEMO[ 下载地址]

2: 编写样例程序

  1. [backcolor=transparent]//此处需要替换成自己的AK信息
  2. [backcolor=transparent]    $accessKeyId [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]"yourAccessKeyId"[backcolor=transparent];
  3. [backcolor=transparent]    $accessKeySecret [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]"yourAccessKeySecret"[backcolor=transparent];
  4. [backcolor=transparent]    [backcolor=transparent]//流量API产品名
  5. [backcolor=transparent]    $product [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]"Dycdpapi"[backcolor=transparent];
  6. [backcolor=transparent]    [backcolor=transparent]//流量API产品域名
  7. [backcolor=transparent]    $domain [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]"dycdpapi.aliyuncs.com"[backcolor=transparent];
  8. [backcolor=transparent]    [backcolor=transparent]//暂时不支持多Region
  9. [backcolor=transparent]    $region [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]"cn-hangzhou"[backcolor=transparent];
  10. [backcolor=transparent]    [backcolor=transparent]//初始化访问的acsCleint
  11. [backcolor=transparent]    $profile [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]DefaultProfile[backcolor=transparent]::[backcolor=transparent]getProfile[backcolor=transparent]([backcolor=transparent]$region[backcolor=transparent],[backcolor=transparent] $accessKeyId[backcolor=transparent],[backcolor=transparent] $accessKeySecret[backcolor=transparent]);
  12. [backcolor=transparent]    [backcolor=transparent]DefaultProfile[backcolor=transparent]::[backcolor=transparent]addEndpoint[backcolor=transparent]([backcolor=transparent]"cn-hangzhou"[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]"cn-hangzhou"[backcolor=transparent],[backcolor=transparent] $product[backcolor=transparent],[backcolor=transparent] $domain[backcolor=transparent]);
  13. [backcolor=transparent]    $acsClient[backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]new[backcolor=transparent] [backcolor=transparent]DefaultAcsClient[backcolor=transparent]([backcolor=transparent]$profile[backcolor=transparent]);
  14. [backcolor=transparent]    $request [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]new[backcolor=transparent] [backcolor=transparent]Dycdpapi[backcolor=transparent]\Request\V[backcolor=transparent]20170823[backcolor=transparent]\PreOrderCheckRequest[backcolor=transparent]();
  15. [backcolor=transparent]    [backcolor=transparent]//选填-待充值号码
  16. [backcolor=transparent]    $request[backcolor=transparent]->[backcolor=transparent]setPhoneNumber[backcolor=transparent]([backcolor=transparent]"1800000000"[backcolor=transparent]);
  17. [backcolor=transparent]    $request[backcolor=transparent]->[backcolor=transparent]setGrade[backcolor=transparent]([backcolor=transparent]"1"[backcolor=transparent]);
  18. [backcolor=transparent]    [backcolor=transparent]//发起访问请求
  19. [backcolor=transparent]    $acsResponse [backcolor=transparent]=[backcolor=transparent] $acsClient[backcolor=transparent]->[backcolor=transparent]getAcsResponse[backcolor=transparent]([backcolor=transparent]$request[backcolor=transparent]);


错误码列表

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

展开
收起
猫饭先生 2017-10-25 14:06:55 1501 分享 版权
阿里云 AI 助理回答

您提到的“预校验接口(PreCheckOrder)”和“定向流量整体流程及操作步骤”似乎关联到一个特定的服务场景,特别是与移动通信服务中的定向流量套餐订购相关。虽然我作为阿里云智能问答机器人,主要聚焦于阿里云产品和服务的解答,我可以尝试根据您的描述提供一些通用指导和建议。

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

  1. 需求分析:确定用户对定向流量的需求,包括应用或服务类型、预计使用量等。

  2. 选择档位:根据需求分析结果,从定向流量价格表中选择合适的订购档位(如您提及的GradeString参数)。

  3. 预校验

    • 使用PreCheckOrder接口进行预校验,确保订购手机号(PhoneNumberString)有效且符合订购条件。
    • 该接口会返回请求ID、状态码和描述信息,帮助确认是否可以继续订购流程。
  4. 技术对接

    • 下载并集成SDK工具包,按照提供的文档将aliyun-php-sdk-core和alicom-dycdp-api添加到项目依赖中。
    • 编写代码调用预校验接口,处理返回的响应,确保逻辑正确处理成功与失败的情况。
  5. 正式订购:在预校验通过后,执行正式的订购操作。这通常涉及另一个API调用,具体步骤需参考服务商提供的API文档。

  6. 订单确认与通知:完成订购后,系统应返回订单详情,并可能通过短信、邮件等方式通知用户订购成功。

  7. 计费与生效:定向流量套餐按订购规则开始计费,并在规定时间内生效,用户可享受定向流量服务。

  8. 售后服务:提供查询、变更、取消订单等售后服务功能,确保用户体验。

参数说明

  • 入参列表

    • PhoneNumberString:用户的手机号,用于验证订购资格。
    • GradeString:订购的流量档位ID,需要参照服务商提供的价格表选择。
  • 出参列表

    • RequestId:每次请求的唯一标识。
    • Code:请求状态码,OK表示成功,其他错误码需查阅错误码列表。
    • Message:对于成功状态的简短描述信息。

技术对接步骤

确保遵循服务商提供的SDK集成指南,正确配置认证信息(如AccessKey ID和AccessKey Secret),并编写安全、高效的代码来调用API。同时,关注API调用的频率限制和错误处理机制,以保证系统的稳定运行。

请注意,具体的实现细节和API调用方式可能会根据实际服务提供商的文档有所差异,务必参考最新的官方文档进行操作。如果这是关于阿里云某项具体服务的问题,请提供更详细的服务名称,以便给出更精确的解答。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答
问答标签:
问答地址: