OVIRO LogoOVIRO
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ả
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)
tagstringTag
genderintGiới tính
ignore_auto_upgradeintBỏ qua tự động nâng cấp hạng (1: Có)
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 (mã, tên, nội bộ tên, SĐT, email, tag)
pageintTrang hiện tại (mặc định 1)
limitintSố bản ghi mỗi trang (mặc định 20)
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