接口查询绑定关系详情

调用QuerySubscriptionDetail查询绑定关系详情,通过本文您可以了解调用查询绑定关系详情接口的操作流程。

前提条件

  1. 注册阿里云账号并完成企业实名认证。具体操作请参见注册阿里云账号企业实名认证

  2. 获取阿里云访问密钥。具体操作,请参见获取AccessKey

明确您所使用的产品类型

目前支持三款产品:AXB_170、AXN_170和AXN_95。

下载对应的SDK和DEMO样例程序编写代码

请到SDK&DEMO下载页面获取相应的SDK和DEMO程序,参照代码样例进行接口开发和调试。

参数

入参列表

参数名称

参数类型

必填与否

样例取值

参数说明

PoolKey

String

必须

FC12345

号池Key。

SubsId

String

必须

12345

创建绑定关系API接口所返回的订购关系ID。

PhoneNoX

String

必须

170****0000

创建绑定关系API接口所返回的X号码。

出参列表

出参名称

出参类型

样例取值

参数说明

RequestId

String

8906582E-6722

请求ID。

Code

String

OK

状态码。返回OK代表请求成功,其他错误码详见错误码列表。

Message

String

请求成功

状态码的描述。

SecretBindDetailDTO

Object

结构体

结构体包含字段说明:

  • subsId:订购关系ID。

  • phoneNoA、phoneNoX、phoneNoB:AXB设备证书(ProductKey、DeviceName、DeviceSecret)。

  • gmtCreate:创建时间。

  • expireDate:失效时间。

  • needRecord:是否需要录音。

  • status:绑定状态。

    • 1:生效。

    • 0-失效。

技术对接步骤

  1. 下载SDK工具包。

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

    • SDK&DEMO下载地址,请参见SDK&DEMO下载

  2. 编写样例程序。

    # -*- coding: utf-8 -*-
    from aliyunsdkdyplsapi.request.v20170525 import QuerySubscriptionDetailRequest
    from aliyunsdkcore.client import AcsClient
    from aliyunsdkcore.profile import region_provider
    """
    隐私保护服务调用接口示例,版本号:v20170525
    Created on 2017-09-18
    """
    # 注意:不要更改
    REGION = "cn-hangzhou"
    PRODUCT_NAME = "Dyplsapi"
    DOMAIN = "dyplsapi.aliyuncs.com"
    # ACCESS_ID/ACCESS_KEY TODO 此处需要替换成开发者自己的AK(在阿里云访问控制台寻找)
    ACCESS_KEY_ID = "yourAccessKeyId"
    ACCESS_KEY_SECRET = "yourAccessKeySecret"
    # 初始化acsClient,暂不支持region化
    acs_client = AcsClient(ACCESS_KEY_ID, ACCESS_KEY_SECRET, REGION)
    region_provider.add_endpoint(PRODUCT_NAME,REGION,DOMAIN)
    def query_demo():
              # 组装请求对象 - 具体描述见控制台 - 文档部分内容
        query_subscription_detail_request = QuerySubscriptionDetailRequest.QuerySubscriptionDetailRequest()
        # 必填 - 对应的号池Key
        query_subscription_detail_request.setPoolKey("FC12345");
        # 必填 - 绑定关系ID;
            query_subscription_detail_request.set_SubsId("1*******6");
        # 必填 - 绑定关系对应的X号码;
            query_subscription_detail_request.set_PhoneNoX("17*******");
        # 调用远程接口,返回json
        query_subscription_detail_response = acs_client.do_action_with_exception(query_subscription_detail_request)
        # TODO 业务处理
        return query_subscription_detail_response  
    # 测试
    __name__ = 'query'
    if __name__ == 'query':
        print query_demo()  
                            

错误码列表

Code

描述

OK

请求成功。

isp.RAM_PERMISSION_DENY

RAM权限DENY。

isv.OUT_OF_SERVICE

业务停机。

isv.PRODUCT_UN_SUBSCRIPT

未开通云通信产品的阿里云客户。

isv.PRODUCT_UNSUBSCRIBE

产品未开通。

isv.ACCOUNT_NOT_EXISTS

账户不存在。

isv.ACCOUNT_ABNORMAL

账户异常。

isp.SYSTEM_ERROR

系统错误。

isp.UNKNOWN_ERR_CODE

运营商未知错误。

isv.PARTNER_NOT_EXIST

未知合作伙伴。

isv.NO_NOT_EXIST

号码不存在。

isv.ILLEGAL_ARGUMENT

参数非法。

isp.DAO_EXCEPTION

数据库异常。

isv.NO_AVAILABLE_NUMBER

无可用号码。

isp.VENDOR_UNAVAILABLE

运营商降级。

isv.FLOW_LIMIT

业务流控。

isv.PARTNER_IS_CLOSED

partner被关停。

isv.FORBIDDEN_ACTION

无权操作。

isv.NO_USED_BY_OTHERS

码被其他业务方占用。

isv.VENDOR_BIND_FAILED

运营商绑定失败。

isv.EXPIRE_DATE_ILLEGAL

过期时间非法。

isv.MOBILE_NUMBER_ILLEGAL

号码格式非法。

isv.BIND_CONFLICT

绑定冲突。