首页 号码隐私保护 API参考 API目录 号码资源管理 QuerySecretNoRemain - 查询线上可购号码余量

QuerySecretNoRemain - 查询线上可购号码余量

查询线上可购号码余量。

接口说明

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

调试

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

调试

授权信息

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

请求参数

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

号码类型。取值:

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

号码的归属地。

  • SpecId设置为1或2时,可以在参数City中指定查询
  1. 支持输入单个城市名称查询。
  2. 支持输入“全国”查询,可返回全国可购号码余量。
  3. 支持输入“全国列表”查询,将返回全国城市中有号码的城市及数量,无号码的城市不会返回。
  • SpecId设置为3时,95号码不区分归属地,只能查询全部95号码可购余量,即必须指定City全国通用
说明当前仅支持设置归属地为中国大陆地区。
杭州
SecretNostring

号码前缀。查询可购号码余量时,如果指定SecretNo,表示查询指定前缀的号码余量。

最长可指定18位号码前缀。

130

返回参数

名称类型描述示例值
object

返回数据。

Codestring

请求状态码。

OK
Messagestring

状态码的描述。

OK
RequestIdstring

请求ID。

9FC30594-3841-43AD-9008-03393BCB5CD2
SecretRemainDTOobject

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

Amountlong

可购号码余量。

0
Citystring

号码的归属地。

杭州
RemainDTOListarray

可购号码余量列表。

object

结构体。

Amountlong

城市可购号码余量。

120
Citystring

号码的归属地。

武汉

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "Message": "OK",
  "RequestId": "9FC30594-3841-43AD-9008-03393BCB5CD2",
  "SecretRemainDTO": {
    "Amount": 0,
    "City": "杭州",
    "RemainDTOList": [
      {
        "Amount": 120,
        "City": "武汉"
      }
    ]
  }
}

错误码

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

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