通用说明

• 如果接口演示站上有，而手册中无，则属于漏掉的接口文档，则以演示站为准

1. 接口方式

• 一律 post 请求
• 401 状态码：账号未审核、账号被冻结、账号不存在、账号不是商户账号
• 403 状态码：无操作权限
• 其余状态码一律 200，返回的 json 中 code 为 1 表示成功，0 表示失败
• 接口参数大小写不敏感，如：getSettings 和 getsettings 效果一样
• 接口限流：5 秒钟最大 40 次；超限信息：{"code":0,"msg":"请求过于频繁，请稍后再

2. 分页与请求参数

• page：页码
• limit：每页数量 默认 20
• date_range：日期范围，格式：['2025-11-01', '2025-11-30']

3. 测试用例

1. 线上演示示例：测试地址

2. 接口工具测试工具：ApiFox

4. 常用函数

时间格式化

import dayjs from 'dayjs';
// 年月日日分秒
export const YYYY_MM_DD_HH_MM_SS = 'YYYY-MM-DD HH:mm:ss';
// 转换为年月日日分秒
export const formatTime = (time: any, format = YYYY_MM_DD_HH_MM_SS) => {
  if (!time) return '';
  if (typeof time !== 'number') {
    return dayjs(time).format(format);
  }
  return dayjs(time * 1000).format(format);
};

5. 手册线上部署时可选参数

1. 增加更新时间配置 提交git

2. 使用 Algolia 搜索