批量添加AXG號碼的綁定關(guān)系。AXG產(chǎn)品是針對有用戶分級需求、限制呼叫范圍、限制搶單等場景的客戶需求提供的號碼隱私保護(hù)解決方案，其中G代表一個號碼組，可以根據(jù)需要添加號碼。
接口說明
-
在 AXG 號碼綁定前，除了購買 X 號碼以外，還必須創(chuàng)建一個 G 號碼組，并在 G 號碼組中添加號碼。若您需要創(chuàng)建 G 號碼組，可參考：設(shè)置 G 號碼組進(jìn)行操作，或者調(diào)用 CreateAxgGroup 接口創(chuàng)建 G 號碼組。
-
AXG 隱私號，綁定號碼前建議您先明確業(yè)務(wù)場景中的 A 角色、G 角色。例如：在招聘平臺中，A 是應(yīng)聘者，G 是招聘團(tuán)隊。
-
調(diào)用此接口批量綁定 AXG 號碼時，若個別 AXG 號碼綁定請求失敗，不影響其他 AXG 號碼綁定請求成功，請求狀態(tài)碼針對單條 AXG 綁定進(jìn)行返回。
QPS 限制
本接口的單用戶 QPS 限制為 5000 次/秒。超過限制，API 調(diào)用會被限流，這可能會影響您的業(yè)務(wù)，請合理調(diào)用。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀?。≧ead）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| dypls:BindBatchAxg | update | *全部資源 * |
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| PoolKey | string | 是 | 號碼池 Key。 在號碼隱私保護(hù)控制臺，號碼池管理頁面獲取號碼池 Key。 | FC2235**** |
| AxgBindList | array<object> | 是 | AXG 綁定列表。 | |
| object | 是 | |||
| PhoneNoA | string | 是 | AXG 中的 A 號碼。 A 號碼可設(shè)置為手機(jī)號碼或固定電話，固定電話需要加區(qū)號，區(qū)號和號碼中間不需要加連字符。 | 139****0000 |
| GroupId | string | 是 | AXG 中的 G 組 ID，即 GID。 可以通過以下方式查看 GID：
說明
G 號碼組中必須有一個及以上的電話號碼。
| 200001234**** |
| PhoneNoB | string | 否 | AXG 中的 B 號碼。 B 號碼可設(shè)置為手機(jī)號碼或固定電話，固定電話需要加區(qū)號，區(qū)號和號碼中間不需要加連字符。 說明
| 138****0000 |
| PhoneNoX | string | 否 | 139****1111 | |
| ExpectCity | string | 否 | 指定城市進(jìn)行 X 號碼的選號。 說明
| 北京 |
| IsRecordingEnabled | boolean | 否 | 是否需要針對該綁定關(guān)系產(chǎn)生的所有通話進(jìn)行通話錄音。取值：
| false |
| OutId | string | 否 | 外部業(yè)務(wù)擴(kuò)展字段，通話記錄回執(zhí)消息中會回傳此參數(shù)。 | 1***********0fd |
| Expiration | string | 否 | 綁定關(guān)系的過期時間，時間單位精確到秒。 說明
| 2022-07-11 01:05:15 |
| OutOrderId | string | 否 | 外部業(yè)務(wù) ID。 | 20***************677 |
| CallDisplayType | integer | 否 | 重置綁定關(guān)系中的號碼顯示邏輯。固定取值：1（主被叫顯示中間號碼 X）。 說明
由于運(yùn)營商監(jiān)管限制，呼叫時顯示真實號碼的設(shè)置不生效。
| 1 |
| RingConfig | string | 否 | 設(shè)置 AXG 隱私號在號碼綁定后，撥打 X 號碼的企業(yè)彩鈴。 此參數(shù)請?zhí)顚?strong data-sourcepos="3:7-3:15">鈴音字段和彩鈴編碼。 鈴音字段取值：
彩鈴編碼： 在號碼隱私保護(hù)控制臺企業(yè)彩鈴管理頁面獲取企業(yè)彩鈴編碼。 填寫示例： 如設(shè)置 A 號碼打 X 的鈴音（無回?fù)芴柎a），填寫："AXGRing_A": "1000****1"。 說明
企業(yè)彩鈴優(yōu)先使用綁定級別設(shè)置的彩鈴，如果未設(shè)置或設(shè)置未生效，則會使用號碼池級別的彩鈴音。
| {"AXGRing_AB":"1000****2","AXGRing_A":"1000****1"} |
| ASRStatus | boolean | 否 | ASR 狀態(tài)。取值：
| true |
| ASRModelId | string | 否 | ASR 模型 ID。取值：
| 7ee372834d2f4cc7ac0d0ab2d0ae1aac |
| CallRestrict | string | 否 | 單通呼叫限制的狀態(tài)。取值：
| CONTROL_AX_DISABLE |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"Code": "OK",
"Message": "OK",
"RequestId": "5DCCA8CD-6C0A-50B4-A496-B1D2AB48A1C3",
"SecretBindList": {
"SecretBind": [
{
"SecretNo": "139****1111",
"SubsId": "1000012345******",
"Extension": "257",
"GroupId": "200001234****",
"PhoneNoA": "139****0000",
"Code": "isv.INVALID_PARAMETERS",
"Message": "ringConfig invalid"
}
]
}
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2023-04-27 | 新增 OpenAPI | 查看變更詳情 |