全部產品
Search

搜尋本產品

    ：ListContact - 擷取連絡人清單

    文件中心

    ：ListContact - 擷取連絡人清單

    更新時間：Dec 17, 2025

    擷取連絡人清單。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-cert:ListContact

    list

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Keyword

    string

    否

    搜尋關鍵詞。例如姓名、郵箱和電話中的關鍵字。

    186
    ShowSize

    integer

    否

    分頁查詢時，設定每頁顯示連絡人的個數。

    20
    CurrentPage

    integer

    否

    分頁，當前頁，預設 1。

    1

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    本次調用請求的 ID，是由阿里雲為該請求產生的唯一識別碼，可用於排查和定位問題。

    31C66C7B-671A-4297-9187-2C4477247A74
    TotalCount

    integer

    搜尋總數量。

    12
    ShowSize

    integer

    分頁查詢時，設定每頁顯示認證的數量。預設值為 20。

    20
    CurrentPage

    integer

    分頁查詢時，設定當前頁面的頁碼。預設值為 1。

    1
    Keyword

    string

    模糊查詢關鍵詞。

    186
    ContactList

    array<object>

    連絡人清單。

    object

    連絡人對象。

    ContactId

    integer

    連絡人 ID。

    519580
    Name

    string

    連絡人姓名。

    張三
    Mobile

    string

    手機號碼。

    139****8888
    MobileStatus

    integer

    手機號碼是否被驗證。

    1
    Email

    string

    連絡人電子郵件地址。

    username@example.com
    EmailStatus

    integer

    郵件地址是否被通過驗證。

    1
    Webhooks

    string

    機器人地址。

    [\"https://open.feishu.cn/open-apis/bot/v2/hook/XXX\",\"https://oapi.dingtalk.com/robot/send?access_token=XXX\",\"https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=XXX\"]

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "31C66C7B-671A-4297-9187-2C4477247A74",
  "TotalCount": 12,
  "ShowSize": 20,
  "CurrentPage": 1,
  "Keyword": "186",
  "ContactList": [
    {
      "ContactId": 519580,
      "Name": "張三",
      "Mobile": "139****8888",
      "MobileStatus": 1,
      "Email": "username@example.com",
      "EmailStatus": 1,
      "Webhooks": "[\\\"https://open.feishu.cn/open-apis/bot/v2/hook/XXX\\\",\\\"https://oapi.dingtalk.com/robot/send?access_token=XXX\\\",\\\"https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=XXX\\\"]"
    }
  ]
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。