CRMKhách hàng

Danh sách khách hàng

Trả về danh sách khách hàng theo các bộ lọc.

Endpoint

GET /v1/customers

Quyền: customer.view hoặc order.add

Query Parameters

TênKiểuBắt buộcMô tả
company_idintCóID công ty (phải trùng với công ty của token; nếu không truyền, kết quả trả về rỗng)
idintID khách hàng cụ thể
idsstringDanh sách ID (ngăn cách bằng dấu phẩy)
customer_type_idintID nhóm khách hàng
is_companyintLà công ty (1: Có, 0: Không)
region_idintID tỉnh/thành phố
codestringMã khách hàng (tìm gần đúng)
phonestringSố điện thoại (tìm gần đúng)
phone_exactlystringSố điện thoại (tìm chính xác)
emailstringEmail (tìm chính xác)
tagstringLọc theo một tag
genderintGiới tính
groupintNhóm đối tác
group_statusintTrạng thái đối tác
group_moderator_idintID người quản lý đối tác
date_startedintThời gian tạo từ (timestamp)
date_endedintThời gian tạo đến (timestamp)
keywordstringTừ khóa tìm kiếm gần đúng (mã, tên, tên nội bộ, SĐT, email, tag)
pageintTrang hiện tại (mặc định 1)
limitintSố bản ghi mỗi trang (mặc định 50, tối đa 50)
sort_bystringSắp xếp theo: id, date_created, point, count_order, date_modified. Mặc định: id
sort_typestringKiểu sắp xếp: ASC, DESC. Mặc định: DESC

Response Schema

HTTP 200 - JSON Object

TrườngKiểuMô tả
totalintTổng số bản ghi
currentpageintTrang hiện tại
limitintSố bản ghi mỗi trang
itemsarrayMảng Customer Object

Mỗi item trong mảng items là một Customer Object.

Error Codes

HTTPCodeMô tả
403error_forbiddenKhông có quyền truy cập

On this page