Skip to content

客户相册与照片管理 API

用于记录客户的治疗对比照、化验单、术前设计图等视觉资料。支持相册分类、多图关联及物理文件上传。

1. 相册列表

GET /api/customer-photo/index

返回客户相册的索引。

  • 返回字段: flag (标记)、 title (标题)、 customer_namecreate_user_id 等。

2. 查看相册详情

返回该相册下的所有照片明细及其访问路径。

GET /api/customer-photo/info

  • 参数: id

3. 物理上传照片

向指定的相册上传二进制图片文件。

POST /api/customer-photo/upload

请求类型: multipart/form-data

参数

  • id : 相册 ID
  • file : 图片二进制文件(必填)
  • remark : 单张照片的备注(可选)

接口行为

  1. 自动生成图片缩略图。
  2. 将原图与缩略图信息存储至 attachments 表。
  3. 自动关联至该客户相册。

4. 创建新相册

POST /api/customer-photo/create

参数

  • customer_id : 顾客 ID
  • title : 相册标题
  • flag : 标记(如:术前、术后、治疗中)
  • remark : 备注