declare namespace API {
  /** 与后端约定的响应数据格式 */
  interface IResponse<T> {
    /** status code: 1 success; other business error */
    status: number;
    /**  response data */
    data?: T;
    /** error code */
    errorCode?: number;
    /** message display to user */
    message?: string;
    /** error display type：0 silent; 1 message.warn; 2 message.error; 4 notification; 9 page */
    showType?: ErrorShowType;
    /** Convenient for back-end Troubleshooting: unique request ID */
    traceId?: string;
    /** Convenient for backend Troubleshooting: host of current access server */
    // host?: string;
  }

  /** 错误显示类型 */
  enum ErrorShowType {
    /** silent */
    SILENT = 0,
    /** message.warn */
    WARN_MESSAGE = 1,
    /** message.error */
    ERROR_MESSAGE = 2,
    /** notification */
    NOTIFICATION = 3,
    /** page */
    REDIRECT = 9,
  }

  /** 分页场景--返回数据格式 */
  interface IPagingData<T> {
    /** 内容 */
    content: T;
    /** 页码 */
    pageNumber?: number;
    /** 页大小 */
    pageSize?: number;
    /** 总记录数 */
    totalElements?: number;
  }

  /** 分页场景--请求数据格式 */
  type PagingParams = {
    /** ⻚码 */
    pageNumber?: number;
    /** ⻚⼤⼩ */
    pageSize?: number;
    /** 排序字段 */
    sortField?: string;
    /** 排序⽅向: asc | desc */
    sortDirection?: 'asc' | 'desc';
    /** 请求参数 */
    searchText?: string;

    [key: string]: any;
  };
}