Skip to content

获取项目列表 API

PathMethodCreated At
/api/projects/paginatePOST2025-11-29 00:39:11

Request

KeyRuleDescription
pageinteger,min:1,max:100页码必须为正整数
page_sizeinteger,min:5,max:1000每页数量必须为正整数
is_archivedApp\Rules\BoolRule是否归档字段错误
sortsarray排序字段不正确

Response

KeyTypeExampleComment
idstring13da12项目ID
namestring路由项目一期项目名称
customerIdstring8d23a客户编号
customerNamestring金职院客户名称
agentIdstring7d2aab渠道ID
agentNamestring铁道游击队渠道名称
projectNostringPJ-101项目编号
contractIdstring823da1合同编号
contractNumberstring5420合同编号
contractTitlestring路由项目一期合同合同项目标题
typeenumProjectType项目类型
totalAmountfloat78900024.32项目总金额
projectLevelenumProjectLevel项目等级
salesLeaderIdint1销售经理ID
salesLeaderNamestring张三丰销售经理
techLeaderIdstring1技术经理ID
techLeaderNamestring李德善技术经理
projectLeaderIdint2项目经理ID
projectLeaderNamestring贾似道项目经理名称
projectStageenumProjectStage项目阶段
deliveryDatestring2025-02-22 21:30:23发货时间
isSignedbooltrue是否终验
durationstring10天项目用时
workHoursstring500小时项目工时
projectStatusenumProjectStatus项目状态
statusenumProjectStatus状态
createdAtstring2021-12-31创建时间
deliveryReceiptTimestring2021-12-31 15:04:05到货签收时间
expectedCompletionTimestring2006-01-02预计完成时间
followersarray[1, 2, 3]关注者

TypeScript Result Example:

TypeScript
interface Result {
  /** 项目ID */
  id: string;
  /** 项目名称 */
  name: string;
  /** 客户编号 */
  customerId: string;
  /** 客户名称 */
  customerName: string;
  /** 渠道ID */
  agentId: string;
  /** 渠道名称 */
  agentName: string;
  /** 项目编号 */
  projectNo: string;
  /** 合同编号 */
  contractId: string;
  /** 合同编号 */
  contractNumber: string;
  /** 合同项目标题 */
  contractTitle: string;
  /** 项目类型 */
  type: ResultType;
  /** 项目总金额 */
  totalAmount: any;
  /** 项目等级 */
  projectLevel: ResultProjectLevel;
  /** 销售经理ID */
  salesLeaderId: number;
  /** 销售经理 */
  salesLeaderName: string;
  /** 技术经理ID */
  techLeaderId: string;
  /** 技术经理 */
  techLeaderName: string;
  /** 项目经理ID */
  projectLeaderId: number;
  /** 项目经理名称 */
  projectLeaderName: string;
  /** 项目阶段 */
  projectStage: ResultProjectStage;
  /** 发货时间 */
  deliveryDate: string;
  /** 是否终验 */
  isSigned: any;
  /** 项目用时 */
  duration: string;
  /** 项目工时 */
  workHours: string;
  /** 项目状态 */
  projectStatus: ResultProjectStatus;
  /** 状态 */
  status: ResultStatus;
  /** 创建时间 */
  createdAt: string;
  /** 到货签收时间 */
  deliveryReceiptTime: string;
  /** 预计完成时间 */
  expectedCompletionTime: string;
  /** 关注者 */
  followers: any;
}

enum ResultType {

}

enum ResultProjectLevel {
  /** 重大项目 */
  MAJOR = "MAJOR",
  /** 大项目 */
  LARGE = "LARGE",
  /** 中小项目 */
  MEDIUM = "MEDIUM",
  /** 微型项目 */
  MICRO = "MICRO"
}

enum ResultProjectStage {
  /** 项目启动 */
  STARTED = "STARTED",
  /** 部分到货 */
  PARTIALLY_DELIVERED = "PARTIALLY_DELIVERED",
  /** 全部到货 */
  ALL_DELIVERED = "ALL_DELIVERED",
  /** 实施 */
  IMPLEMENTED = "IMPLEMENTED",
  /** 初验 */
  INITIAL_ACCEPTANCE = "INITIAL_ACCEPTANCE",
  /** 终验 */
  FINAL_ACCEPTANCE = "FINAL_ACCEPTANCE"
}

enum ResultProjectStatus {
  /** 正常进行中 */
  PROCESSING = "PROCESSING",
  /** 问题异常 */
  EXCEPTED = "EXCEPTED",
  /** 项目完结 */
  COMPLETED = "COMPLETED"
}

enum ResultStatus {
  /** 正常进行中 */
  PROCESSING = "PROCESSING",
  /** 问题异常 */
  EXCEPTED = "EXCEPTED",
  /** 项目完结 */
  COMPLETED = "COMPLETED"
}

Enums

ProjectType

ConstDescription

ProjectLevel

ConstDescription
MAJOR重大项目
LARGE大项目
MEDIUM中小项目
MICRO微型项目

ProjectStage

ConstDescription
STARTED项目启动
PARTIALLY_DELIVERED部分到货
ALL_DELIVERED全部到货
IMPLEMENTED实施
INITIAL_ACCEPTANCE初验
FINAL_ACCEPTANCE终验

ProjectStatus

ConstDescription
PROCESSING正常进行中
EXCEPTED问题异常
COMPLETED项目完结