BuySecretNo - 购买号码

调用BuySecretNo接口购买号码。

接口说明

  • 在控制台创建号码池后,号码池默认为空,需要为号码池购买号码。

  • 购买号码操作涉及到资源资费,请确保在使用该接口前,已充分了解X号码隐私保护产品的收费方式和价格

  • 购买号码时,指定归属地如果没有足够号码可供购买,会造成号码购买失败。调用此接口购买号码前,请先通过QuerySecretNoRemain查询线上可购号码余量。

  • 购买号码的账号必须已实名认证为企业账号。如何进行实名认证,请参见企业实名认证

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
PoolKeystring

号码池Key。请登录号码隐私保护控制台,在号码池管理中查看号码池Key。

FC123456
SpecIdLong

号码类型。取值:

  • 1:虚商号码,即170或171。
  • 2:运营商号码。
  • 3:95号码。
1
Citystring

指定号码的归属地。

说明
  • 当前仅支持设置归属地为中国大陆地区。
    • 95号码不区分地区,如果购买95号码,则该参数应指定为全国通用
    杭州
    SecretNostring

    指定号码前缀。购买号码时,如果指定SecretNo,会根据指定的号码前缀模糊匹配手机号。

    说明最长可指定18位号码前缀。
    130
    DisplayPoolboolean

    是否将该号码置于显号池。

    说明该参数仅对开通显号功能的客户生效。
    true

    返回参数

    名称类型描述示例值
    object
    Codestring

    请求状态码。

    OK
    Messagestring

    状态码的描述。

    OK
    RequestIdstring

    请求ID。

    2D1AEB96-96D0-454E-B0DC-AE2A8DF08020
    SecretBuyInfoDTOobject

    接口调用成功后返回的结构体。

    SecretNostring

    隐私号码,即X号码。

    1390000****

    示例

    正常返回示例

    JSON格式

    {
      "Code": "OK",
      "Message": "OK",
      "RequestId": "2D1AEB96-96D0-454E-B0DC-AE2A8DF08020",
      "SecretBuyInfoDTO": {
        "SecretNo": "1390000****"
      }
    }

    错误码

    访问错误中心查看更多错误码。

    阿里云首页 号码隐私保护 相关技术圈