调用BuySecretNo接口购买号码。

说明
  • 在控制台创建号码池后,号码池默认为空,需要为号码池购买号码。
  • 购买号码操作涉及到资源资费,请确保在使用该接口前,已充分了解X号码隐私保护产品的收费方式和价格
  • 购买号码时,指定归属地如果没有足够号码可供购买,会造成号码购买失败。调用此接口购买号码前,请先通过QuerySecretNoRemain查询线上可购号码余量。
  • 购买号码的账号必须已实名认证为企业账号。如何进行实名认证,请参见企业实名认证

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String BuySecretNo

系统规定参数。取值:BuySecretNo

City String 杭州

指定号码的归属地。

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

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

SpecId Long 1

号码类型。取值:

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

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

说明 最长可指定18位号码前缀。
DisplayPool Boolean true

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

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

返回数据

名称 类型 示例值 描述
Code String OK

请求状态码。

  • 返回OK代表请求成功。
  • 其他错误码,请参见错误码列表
Message String OK

状态码的描述。

RequestId String 2D1AEB96-96D0-454E-B0DC-AE2A8DF08020

请求ID。

SecretBuyInfoDTO Struct

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

SecretNo String 17100000000

隐私号码,即X号码。

示例

请求示例

https://dyplsapi.aliyuncs.com/?Action=BuySecretNo
&City=杭州
&PoolKey=FC123456
&SpecId=1
&<公共请求参数>

正常返回示例

XML格式

<BuySecretNoResponse>
	  <SecretBuyInfoDTO>
		    <SecretNo>17100000000</SecretNo>
	  </SecretBuyInfoDTO>
	  <Message>OK</Message>
	  <RequestId>2D1AEB96-96D0-454E-B0DC-AE2A8DF08020</RequestId>
	  <Code>OK</Code>
</BuySecretNoResponse>

JSON格式

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

错误码

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