调用BuySecretNo接口购买号码。
接口说明
- 在控制台创建号码池后，号码池默认为空，需要为号码池购买号码。
- 购买号码操作涉及到资源资费，请确保在使用该接口前，已充分了解X号码隐私保护产品的收费方式和价格。
- 购买号码时，指定归属地如果没有足够号码可供购买，会造成号码购买失败。调用此接口购买号码前，请先通过QuerySecretNoRemain查询线上可购号码余量。
- 购买号码的账号必须已实名认证为企业账号。如何进行实名认证，请参见企业实名认证。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试授权信息
当前API暂无授权信息透出。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| PoolKey | string | 是 | 号码池Key。请登录号码隐私保护控制台，在号码池管理中查看号码池Key。 | FC123456 |
| SpecId | long | 是 | 号码类型。取值：
| 1 |
| City | string | 是 | 指定号码的归属地。 说明 | 杭州 |
| SecretNo | string | 否 | 指定号码前缀。购买号码时，如果指定SecretNo，会根据指定的号码前缀模糊匹配手机号。 说明最长可指定18位号码前缀。 | 130 |
| DisplayPool | boolean | 否 | 是否将该号码置于显号池。 说明该参数仅对开通显号功能的客户生效。 | true |
返回参数
示例
正常返回示例
JSON格式
{
"Code": "OK",
"Message": "OK",
"RequestId": "2D1AEB96-96D0-454E-B0DC-AE2A8DF08020",
"SecretBuyInfoDTO": {
"SecretNo": "1390000****"
}
}错误码
访问错误中心查看更多错误码。