获取客户列表 API

Path	Method	Created At
/api/customers/paginate	POST	2025-11-29 00:39:11

Request

Key	Rule	Description
page	integer,min:1,max:100	页码不正确
page_size	integer,min:5,max:1000	每页数量不正确
conditions	array	查询条件不正确
sorts	array	排序字段不正确

Response

Key	Type	Example	Comment
id	string	1	编号
customerNo	string	00001	客户编号
name	string	金华职业技术学院	客户名称
description	string	非常 nice 的客户	客户描述
levelName	string	战略级	客户等级
managerId	int	2	负责人ID
industryId	int	4	行业ID
totalTurnover	float	23.00	总成交额
rank	int	1	排名
partnerRelationship	string	target	合作关系
levelId	int	5	等级
industryPath	array	["上级", "下级", "下下级"]	行业名称
managerName	string	张三	负责人姓名
areaCode	array	["33", "3301", "330102"]	所在区域编码
area	array	["浙江省", "杭州市", "西湖区"]	所在区域
departmentId	int	3	部门ID
departmentPath	array	["上级", "下级", "下下级"]	部门名称
projectNumber	int	99	项目数量
address	string	辖沙街道	地质
type	enum	CustomerType	客户类型
followers	array	[1, 2, 3]	关注者编号
createdAt	string	2021-08-01 12:00:00	创建时间
from	string	customer	来源
advantageousIndustry	string	电信	优势行业
creditSituation	string	优秀	信用状况
isPinned	bool	true	是否置顶

TypeScript Result Example:

interface Result {
  /** 编号 */
  id: string;
  /** 客户编号 */
  customerNo: string;
  /** 客户名称 */
  name: string;
  /** 客户描述 */
  description: string;
  /** 客户等级 */
  levelName: string;
  /** 负责人ID */
  managerId: number;
  /** 行业ID */
  industryId: number;
  /** 总成交额 */
  totalTurnover: any;
  /** 排名 */
  rank: number;
  /** 合作关系 */
  partnerRelationship: string;
  /** 等级 */
  levelId: number;
  /** 行业名称 */
  industryPath: any;
  /** 负责人姓名 */
  managerName: string;
  /** 所在区域编码 */
  areaCode: any;
  /** 所在区域 */
  area: any;
  /** 部门ID */
  departmentId: number;
  /** 部门名称 */
  departmentPath: any;
  /** 项目数量 */
  projectNumber: number;
  /** 地质 */
  address: string;
  /** 客户类型 */
  type: ResultType;
  /** 关注者编号 */
  followers: any;
  /** 创建时间 */
  createdAt: string;
  /** 来源 */
  from: string;
  /** 优势行业 */
  advantageousIndustry: string;
  /** 信用状况 */
  creditSituation: string;
  /** 是否置顶 */
  isPinned: any;
}

enum ResultType {
  /** 正式客户 */
  CLIENT = "CLIENT",
  /** 目标客户 */
  TARGET_CUSTOMER = "TARGET_CUSTOMER",
  /** 沟通客户 */
  PROSPECT = "PROSPECT"
}

Enums

CustomerType

Const	Description
CLIENT	正式客户
TARGET_CUSTOMER	目标客户
PROSPECT	沟通客户