我的资源接口

网关前缀：/ai
Base：/v1/my-resource
鉴权：Bearer Token（只操作当前登录用户的资源）
统一响应：{ "code": 0, "msg": null, "data": ... }

表：marketplace_user_resource
只存 bizType + bizId；查询时按云集市 query-biz 回源原始业务数据到 card.bizData。

同一用户同一 bizType + bizId 不可重复；再次 POST 视为更新备注/排序。

---

一、接口一览

用途	方法	路径
分页查询	GET	/v1/my-resource/page
详情	GET	/v1/my-resource/{id}
加入	POST	/v1/my-resource
更新	PUT	/v1/my-resource
移除	DELETE	/v1/my-resource/{id}

---

二、字段说明

资源记录

字段	类型	说明
id	Long	资源记录主键（雪花）
userId	Long	所属用户（服务端写入，无需传）
bizType	String	expert / light_app / doc_template / feed
bizId	Long	云集市业务主键
remark	String	备注，可选
sortOrder	Integer	排序，默认 0
createTime	datetime	加入时间
card	object	云集市卡片（查询/加入时回源）

card（与云集市卡片一致）

字段	说明
title / subtitle / description / coverUrl	展示信息
priceText / costPoints / recommended / unlockCondition	来自标签绑定
tags	已绑标签（按组）
bizData	原始业务体：expert=ai_agent；light_app=商店模板；doc_template=marketplace_doc_template

---

三、分页查询

GET /v1/my-resource/page

参数	位置	说明
current	query	页码，默认 1
size	query	每页条数，默认 10
bizType	query	可选；不传则全部类型

示例：

GET /ai/v1/my-resource/page?current=1&size=10&bizType=doc_template

data 为 MyBatis-Plus 分页：

{
  "records": [
    {
      "id": 90001,
      "userId": 1,
      "bizType": "doc_template",
      "bizId": 8604575999226273,
      "remark": "常用模板",
      "sortOrder": 1,
      "createTime": "2026-08-18T15:00:00",
      "card": {
        "bizType": "doc_template",
        "bizId": 8604575999226273,
        "title": "抵押贷款还款协议范本word模板.docx",
        "subtitle": "文档模板",
        "coverUrl": "/admin/sys-file/oss/file?fileName=xxx.png",
        "priceText": "免费",
        "recommended": false,
        "unlockCondition": false,
        "tags": [],
        "actionLabel": "立即使用",
        "bizData": {
          "id": 8604575999226273,
          "name": "抵押贷款还款协议范本word模板.docx",
          "size": 14699,
          "fileId": "",
          "contentLength": 14699,
          "fileType": "docx",
          "thumbnailUrl": "/admin/sys-file/oss/file?fileName=xxx.png"
        }
      }
    }
  ],
  "total": 1,
  "size": 10,
  "current": 1,
  "pages": 1
}

---

四、详情

GET /v1/my-resource/{id}

data 为单条资源对象（字段同分页 records[]，含 card.bizData）。
非本人记录返回「资源不存在」。

---

五、加入

POST /v1/my-resource

{
  "bizType": "doc_template",
  "bizId": 8604575999226273,
  "remark": "常用模板",
  "sortOrder": 1
}

bizType、bizId 必填。已存在则更新备注/排序。
data：落库后的完整对象（含 id、card）。

---

六、更新

PUT /v1/my-resource

{
  "id": 90001,
  "bizType": "doc_template",
  "bizId": 8604575999226273,
  "remark": "改备注",
  "sortOrder": 2
}

id 必填。data：true / false。

---

七、移除

DELETE /v1/my-resource/{id}

物理删除（可再次加入）。data：true / false。