查询多个企业联系人信息

同时查询多个企业联系人的详细信息。

请求 URL

GET {base_url}/{api_path}/company_contact/query?access_token={access_token}

请求参数

表 1.
参数 是否必填 类型 说明
ids 是 String 企业联系人的唯一 ID。
注：

响应参数

表 2.
参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
data Array<Contact_DetailInfo> 企业联系人详细信息。
Contact_DetailInfo
表 3.
参数 类型 说明
id Integer 企业联系人的唯一 ID。
first_name String 名称。
last_name String 姓氏。
company String 公司。
email String 邮箱。
phonebook_list Array<Phonebook_List> 企业联系人群组列表。
remark String 备注。
number_list Array<Number_List> 企业联系人号码列表。
zip_code String 邮政编码。
street String 街道。
city String 城市。
state String 州（省）。
country String 国家。
Phonebook_List
表 4.
参数 类型 说明
id Integer 企业联系人群组的唯一 ID。
name String 企业联系人群组名称。
Number_List
表 5.
参数 类型 说明
num_type String 号码类型。
  • business_number：办公号码
  • business_number2：办公号码 2
  • business_fax： 公司传真
  • mobile_number：手机号码
  • mobile_number2：手机号码 2
  • home_number：家庭号码
  • home_number2：家庭号码 2
  • home_fax：家庭传真
  • other_number：其他号码
number String 号码。

示例

请求示例

GET /openapi/v1.0/company_contact/query?id=3,4&access_token=6pAmpgdKOOCr1BtI9tCRJpjVXZPdgLYf HTTP/1.1  
Host: 192.168.5.150:8088

响应示例

HTTP/1.1 200 OK

{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "data": [
        {
            "first_name": "Joseph",
            "last_name": "Goffin",
            "email": "joseph@gmail.com",
            "company": "Ticketsales",
            "zip_code": "",
            "street": "",
            "city": "",
            "state": "",
            "country": "",
            "number_list": [
                {
                    "num_type": "business_number",
                    "number": "12354978652"
                }
            ],
            "id": 3,
            "phonebook_list": [
                {
                    "id": 5,
                    "name": "Vendor"
                },
                {
                    "id": 3,
                    "name": "All Company Contacts_Phonebook"
                }
            ],
            "remark": ""
        },
        {
            "first_name": "Jay",
            "last_name": "Prichett",
            "email": "jayprichett@icloud.com",
            "company": "Closet",
            "zip_code": "41007",
            "street": "",
            "city": "Baltimore",
            "state": "Kentucky (KY)",
            "country": "United States",
            "number_list": [
                {
                    "num_type": "business_number",
                    "number": "001-5503308"
                },
                {
                    "num_type": "mobile_number",
                    "number": "15735810000"
                },
                {
                    "num_type": "other_number",
                    "number": "001-5503301"
                }
            ],
            "id": 4,
            "phonebook_list": [
                {
                    "id": 5,
                    "name": "Vendor"
                },
                {
                    "id": 3,
                    "name": "All Company Contacts_Phonebook"
                }
            ],
            "remark": ""
        }
    ]
}