查询单个企业联系人群组信息

查询单个企业联系人群组的详细信息。

请求 URL

GET {base_url}/{api_path}/phonebook/get?access_token={access_token}

请求参数

表 1.
参数 是否必填 类型 说明
id 是 Integer 企业联系人群组的唯一 ID。
注： 可使用 搜索特定企业联系人群组 接口查询企业联系人群组 ID。

响应参数

表 2.
参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
data Object<Phonebook_DetailInfo> 企业联系人群组信息。
Phonebook_DetailInfo
表 3.
参数 类型 说明
id Integer 企业联系人群组的唯一 ID。
name String 企业联系人群组名称。
member_select String 联系人选择方式。
  • sel_all：选择所有企业联系人。
  • sel_specific：选择指定企业联系人。
contacts_list Array<Contacts_List> 包含的企业联系人信息。
total Integer 包含的企业联系人总数。
Contacts_List
表 4.
参数 类型 说明
id Integer 企业联系人的唯一 ID。
contact_name String 企业联系人名称。
company String 公司。
email String 邮箱。
business String 办公号码。
business2 String 办公号码 2。
mobile String 手机号码。
mobile2 String 手机号码 2。
home String 家庭号码。
home2 String 家庭号码 2。
home_fax String 家庭传真。
business_fax String 公司传真。
other String 其他号码。
remark String 备注。

示例

请求示例

GET /openapi/v1.0/phonebook/get?id=5&access_token=go18MODkNUAOReyKCnKzm6HEr6qTD1Pq HTTP/1.1 
Host: 192.168.5.150:8088

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "data": {
        "id": 5,
        "name": "Vendor",
        "member_select": "sel_specific",
        "contacts_list": [
            {
                "id": 3,
                "contact_name": "Joseph Goffin",
                "company": "Ticketsales",
                "email": "joseph@gmail.com",
                "business": "12354978652"
            },
            {
                "id": 4,
                "contact_name": "Jay Prichett",
                "company": "Closet",
                "email": "jayprichett@icloud.com",
                "business": "001-5503308",
                "mobile": "15735810000"
            },
            {
                "id": 8,
                "contact_name": "Test P-Series",
                "company": "Yeastar",
                "email": "test@icloud.com",
                "business": "12333333",
                "remark": "contact_for_test"
            },
            {
                "id": 10,
                "contact_name": "P-Series",
                "company": "Yeastar",
                "email": "test@icloud.com",
                "business": "5503301",
                "remark": "contact_for_test"
            },
            {
                "id": 11,
                "contact_name": "Example Li",
                "company": "Yeastar",
                "email": "liexample@icloud.com",
                "business": "12333333",
                "remark": "contact_for_test"
            },
            {
                "id": 29,
                "contact_name": "Test-contact",
                "business": "55667788"
            },
            {
                "id": 30,
                "contact_name": "Test-contact2",
                "business": "9910101111"
            },
            {
                "id": 32,
                "contact_name": "Test-contact3",
                "company": "Yeastar",
                "email": "testcontact@126.com",
                "business": "1235555999"
            }
        ],
        "total": 8
    }
}