Liên hệ — Chi tiết

Lấy đầy đủ thông tin một liên hệ theo ID, bao gồm công ty, cơ hội và hoạt động liên quan.

Xem Markdown

Endpoint GET /v1/contacts/{id} trả về toàn bộ hồ sơ một liên hệ, kèm các tài nguyên liên quan khi bạn dùng tham số expand.

Endpoint

MethodEndpointMô tả
GET/v1/contacts/{id}Chi tiết liên hệ theo ID

Tham số đường dẫn & truy vấn

Tham sốVị tríBắt buộcMô tả
idpathCóĐịnh danh liên hệ, ví dụ con_8f2a1c9d
expandqueryKhôngDanh sách quan hệ nhúng kèm: company, deals, activities

Kiểm thử tại chỗ

GEThttps://crm-gateways.hitechcloud.vn/v1/contacts/{id}

Nhập ID liên hệ và Access Token rồi bấm Gửi thử. Token không được lưu lại.

Tham số đường dẫn
Query
cURL lấy chi tiết liên hệ
curl -X GET "https://crm-gateways.hitechcloud.vn/v1/contacts/con_8f2a1c9d?expand=company,deals" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"
Phản hồi (200 OK)
{
  "status": "success",
  "data": {
    "id": "con_8f2a1c9d",
    "first_name": "Nguyen",
    "last_name": "Van A",
    "email": "vana@example.com",
    "phone": "0901234567",
    "lifecycle_stage": "customer",
    "lead_source": "website",
    "tags": ["vip"],
    "custom_fields": { "ma_so_thue": "0312345678" },
    "company": {
      "id": "co_4b7e2f10",
      "name": "Cong ty TNHH ABC"
    },
    "deals": [
      { "id": "deal_a19c330e", "title": "Goi Cloud Server", "amount": 24000000 }
    ],
    "created_at": "2026-09-01T08:00:00+07:00",
    "updated_at": "2026-10-31T09:40:00+07:00"
  }
}
Nếu ID không tồn tại hoặc không thuộc tài khoản của bạn, API trả về lỗi 404 NOT_FOUND.