查询线上可购号码余量。
接口说明
购买号码时,指定归属地如果没有足够号码可供购买,会造成号码购买失败。调用接口BuySecretNo购买号码前,请先通过接口QuerySecretNoRemain查询线上可购号码余量。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
SpecId | long | 是 | 号码类型。取值:
| 1 |
City | string | 是 | 号码的归属地。
说明当前仅支持设置归属地为中国大陆地区。 | 杭州 |
SecretNo | string | 否 | 号码前缀。查询可购号码余量时,如果指定SecretNo,表示查询指定前缀的号码余量。 最长可指定18位号码前缀。 | 130 |
返回参数
示例
正常返回示例
JSON
格式
{
"Code": "OK",
"Message": "OK",
"RequestId": "9FC30594-3841-43AD-9008-03393BCB5CD2",
"SecretRemainDTO": {
"Amount": 0,
"City": "杭州",
"RemainDTOList": {
"remainDTO": [
{
"Amount": 120,
"City": "武汉"
}
]
}
}
}
错误码
访问错误中心查看更多错误码。