BindYBForAXYB - 绑定YBForAXYB--语音服务-火山引擎

文档中心

立即注册

导航

BindYBForAXYB - 绑定YBForAXYB

最近更新时间：2025.07.11 17:27:24首次发布时间：2025.07.11 17:27:24

通过该接口创建AXYB中的YB绑定关系

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	BindYBForAXYB	要执行的操作，取值：BindYBForAXYB。
Version	String	是	2022-01-01	API的版本，取值：2022-01-01。
ParentSubId	String	是	S160817372431596661	父级关系绑定ID
PhoneNoY	String	否	1234xxx	Y号码
PhoneNoB	String	是	13700000001	B号码，可设置为手机号码或固定电话。固定电话需要加区号，区号和号码中间不需要加连字符，例如：02131075869。特服号码如95、1010、400、800类别号码请提前联系火山引擎报备。
NumberPoolNo	String	是	NP160084061100694433	Y号码所在的号码池编号
EnableDuration	Integer	是	180	有效时长（单位秒）
CityCode	String	否	010	选号指定城市；选号优先级： CityCode >CityCodeByPhoneNo（如果传B号码，则按B号码所在城市选号，如果不传B号码，则按A号码所在城市选号）> degradeCityList 降级城市（城市Code详见链接）选号指定城市；
CityCodeByPhoneNo	String	否	A	根据哪个号码所在的城市选号（A：A号码所在城市，B：B号码所在城市）（默认A）
DegradeCityList	Array of String	否	010,0531	降级城市列表，当指定城市选不到号时将会按降级城市进行选号；若希望按照省会城市降级，需要在降级列表中加入"PNPC"代表省会城市降级。例: ("PNPC","010","021")。最多支持设置5个降级城市；
AudioRecordFlag	Integer	否	1	是否需要录音 0：关闭，1 : 开启（默认开启）
RandomFlag	Integer	否	1	是否使用随机选号 0：关闭（默认关闭），1 : 开启。
UserData	String	否	123456	用户拓展参数，最大长度为2048

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
SubId	String	S160817372431596661	绑定关系ID
PhoneNoY	String	17000000000	Y号码
Status	Integer	1	绑定关系状态（0 已解绑，1 已绑定，2 绑定异常）

请求示例

POST /?Action=BindYBForAXYB&Version=2022-01-01 HTTP/1.1
Host: https://cloud-vms.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20250603T105258Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250603/cn-beijing/vms/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "ParentSubId": "S160817372431596661",
  "PhoneNoY": "e",
  "PhoneNoB": "13700000001",
  "NumberPoolNo": "NP160084061100694433",
  "EnableDuration": 180,
  "AudioRecordFlag": 1,
  "CityCode": "010",
  "CityCodeByPhoneNo": "A",
  "DegradeCityList": [
    "010","0531"
  ],
  "RandomFlag": 1,
  "UserData": "123456"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20250314164213155137103028882C78",
    "Action": "BindYBForAXYB",
    "Version": "2022-01-01",
    "Service": "vms",
    "Region": "cn-beijing"
  },
  "Result": {
    "SubId": "S160817372431596661",
    "PhoneNoY": "17000000000",
    "Status": 1
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息
200	SystemError	系统错误
200	IllegalArgument	非法的参数
200	IllegalPhoneNoY	无效的Y号码