{"openapi":"3.1.0","info":{"version":"0.1.0","title":"Babble API"},"components":{"schemas":{},"parameters":{}},"paths":{"/p/{code}":{"get":{"parameters":[{"schema":{"type":"string","minLength":1},"required":true,"name":"code","in":"path"}],"responses":{"200":{"description":"公开 memo JSON","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"content":{"type":"string"},"visibility":{"type":"string","enum":["public","private"]},"pinned":{"type":"boolean"},"rowStatus":{"type":"string","enum":["normal","archived"]},"tags":{"type":"array","items":{"type":"string"}},"resources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"memoId":{"type":"number","nullable":true},"name":{"type":"string"},"type":{"type":"string"},"size":{"type":"number"},"url":{"type":"string"},"createdTs":{"type":"number"}},"required":["id","uid","memoId","name","type","size","url","createdTs"]}},"createdTs":{"type":"number"},"updatedTs":{"type":"number"}},"required":["id","uid","content","visibility","pinned","rowStatus","tags","resources","createdTs","updatedTs"]}}}},"404":{"description":"短码无效或 memo 非公开","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/auth/login":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","minLength":1},"password":{"type":"string","minLength":1}},"required":["username","password"]}}}},"responses":{"200":{"description":"登录成功","content":{"application/json":{"schema":{"type":"object","properties":{"accessToken":{"type":"string"},"refreshToken":{"type":"string"},"user":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"username":{"type":"string"},"role":{"type":"string"},"createdTs":{"type":"number"}},"required":["id","uid","username","role","createdTs"]}},"required":["accessToken","refreshToken","user"]}}}},"401":{"description":"用户名或密码错误","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"429":{"description":"登录尝试过于频繁","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"503":{"description":"JWT_SECRET 未配置","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/auth/refresh":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"refreshToken":{"type":"string","minLength":1}},"required":["refreshToken"]}}}},"responses":{"200":{"description":"新 token 对（refresh 轮换）","content":{"application/json":{"schema":{"type":"object","properties":{"accessToken":{"type":"string"},"refreshToken":{"type":"string"},"user":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"username":{"type":"string"},"role":{"type":"string"},"createdTs":{"type":"number"}},"required":["id","uid","username","role","createdTs"]}},"required":["accessToken","refreshToken","user"]}}}},"401":{"description":"刷新令牌无效","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"503":{"description":"JWT_SECRET 未配置","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/me":{"get":{"responses":{"200":{"description":"当前用户","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"username":{"type":"string"},"role":{"type":"string"},"createdTs":{"type":"number"}},"required":["id","uid","username","role","createdTs"]}}}},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}},"patch":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","minLength":1,"maxLength":64},"currentPassword":{"type":"string","minLength":1},"newPassword":{"type":"string","minLength":8}},"required":["currentPassword"]}}}},"responses":{"200":{"description":"更新成功","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"username":{"type":"string"},"role":{"type":"string"},"createdTs":{"type":"number"}},"required":["id","uid","username","role","createdTs"]}}}},"400":{"description":"未提供任何修改","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"401":{"description":"当前密码错误或未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"409":{"description":"用户名已存在","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/auth/tokens":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64}},"required":["name"]}}}},"responses":{"201":{"description":"创建成功（token 明文仅此一次返回）","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"token":{"type":"string"},"name":{"type":"string"},"createdTs":{"type":"number"}},"required":["id","token","name","createdTs"]}}}},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}},"get":{"responses":{"200":{"description":"令牌列表","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"createdTs":{"type":"number"},"lastUsedTs":{"type":"number","nullable":true}},"required":["id","name","createdTs","lastUsedTs"]}}},"required":["items"]}}}},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/auth/tokens/{id}":{"delete":{"parameters":[{"schema":{"type":"number","nullable":true},"required":false,"name":"id","in":"path"}],"responses":{"204":{"description":"已吊销"},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"404":{"description":"令牌不存在","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/timeline":{"get":{"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"required":false,"name":"page_size","in":"query"},{"schema":{"type":"string"},"required":false,"name":"tag","in":"query"},{"schema":{"type":"string"},"required":false,"name":"keyword","in":"query"}],"responses":{"200":{"description":"公开 memo 时间线（仅 visibility=public 且未归档）","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"number"},"page":{"type":"number"},"page_size":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"content":{"type":"string"},"visibility":{"type":"string","enum":["public","private"]},"pinned":{"type":"boolean"},"rowStatus":{"type":"string","enum":["normal","archived"]},"tags":{"type":"array","items":{"type":"string"}},"resources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"memoId":{"type":"number","nullable":true},"name":{"type":"string"},"type":{"type":"string"},"size":{"type":"number"},"url":{"type":"string"},"createdTs":{"type":"number"}},"required":["id","uid","memoId","name","type","size","url","createdTs"]}},"createdTs":{"type":"number"},"updatedTs":{"type":"number"}},"required":["id","uid","content","visibility","pinned","rowStatus","tags","resources","createdTs","updatedTs"]}}},"required":["total","page","page_size","items"]}}}}}}},"/api/v1/memos":{"get":{"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"page_size","in":"query"},{"schema":{"type":"string"},"required":false,"name":"tag","in":"query"},{"schema":{"type":"string","enum":["public","private"]},"required":false,"name":"visibility","in":"query"},{"schema":{"type":"string","enum":["true","false","all"],"default":"false"},"required":false,"name":"archived","in":"query"},{"schema":{"type":"string"},"required":false,"name":"keyword","in":"query"},{"schema":{"type":"number","nullable":true},"required":false,"name":"start_ts","in":"query"},{"schema":{"type":"number","nullable":true},"required":false,"name":"end_ts","in":"query"}],"responses":{"200":{"description":"memo 列表","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"content":{"type":"string"},"visibility":{"type":"string","enum":["public","private"]},"pinned":{"type":"boolean"},"rowStatus":{"type":"string","enum":["normal","archived"]},"tags":{"type":"array","items":{"type":"string"}},"resources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"memoId":{"type":"number","nullable":true},"name":{"type":"string"},"type":{"type":"string"},"size":{"type":"number"},"url":{"type":"string"},"createdTs":{"type":"number"}},"required":["id","uid","memoId","name","type","size","url","createdTs"]}},"createdTs":{"type":"number"},"updatedTs":{"type":"number"}},"required":["id","uid","content","visibility","pinned","rowStatus","tags","resources","createdTs","updatedTs"]}},"page":{"type":"number"},"page_size":{"type":"number"},"total":{"type":"number"}},"required":["items","page","page_size","total"]}}}},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}},"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","minLength":1},"visibility":{"type":"string","enum":["public","private"]}},"required":["content"]}}}},"responses":{"201":{"description":"创建成功","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"content":{"type":"string"},"visibility":{"type":"string","enum":["public","private"]},"pinned":{"type":"boolean"},"rowStatus":{"type":"string","enum":["normal","archived"]},"tags":{"type":"array","items":{"type":"string"}},"resources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"memoId":{"type":"number","nullable":true},"name":{"type":"string"},"type":{"type":"string"},"size":{"type":"number"},"url":{"type":"string"},"createdTs":{"type":"number"}},"required":["id","uid","memoId","name","type","size","url","createdTs"]}},"createdTs":{"type":"number"},"updatedTs":{"type":"number"}},"required":["id","uid","content","visibility","pinned","rowStatus","tags","resources","createdTs","updatedTs"]}}}},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/memos/{id}":{"get":{"parameters":[{"schema":{"type":"string","minLength":1},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"memo 详情","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"content":{"type":"string"},"visibility":{"type":"string","enum":["public","private"]},"pinned":{"type":"boolean"},"rowStatus":{"type":"string","enum":["normal","archived"]},"tags":{"type":"array","items":{"type":"string"}},"resources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"memoId":{"type":"number","nullable":true},"name":{"type":"string"},"type":{"type":"string"},"size":{"type":"number"},"url":{"type":"string"},"createdTs":{"type":"number"}},"required":["id","uid","memoId","name","type","size","url","createdTs"]}},"createdTs":{"type":"number"},"updatedTs":{"type":"number"}},"required":["id","uid","content","visibility","pinned","rowStatus","tags","resources","createdTs","updatedTs"]}}}},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"404":{"description":"memo 不存在","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}},"patch":{"parameters":[{"schema":{"type":"number","nullable":true},"required":false,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","minLength":1},"visibility":{"type":"string","enum":["public","private"]},"pinned":{"type":"boolean"},"rowStatus":{"type":"string","enum":["normal","archived"]}}}}}},"responses":{"200":{"description":"更新成功","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"content":{"type":"string"},"visibility":{"type":"string","enum":["public","private"]},"pinned":{"type":"boolean"},"rowStatus":{"type":"string","enum":["normal","archived"]},"tags":{"type":"array","items":{"type":"string"}},"resources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"memoId":{"type":"number","nullable":true},"name":{"type":"string"},"type":{"type":"string"},"size":{"type":"number"},"url":{"type":"string"},"createdTs":{"type":"number"}},"required":["id","uid","memoId","name","type","size","url","createdTs"]}},"createdTs":{"type":"number"},"updatedTs":{"type":"number"}},"required":["id","uid","content","visibility","pinned","rowStatus","tags","resources","createdTs","updatedTs"]}}}},"400":{"description":"未提供任何字段","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"404":{"description":"memo 不存在","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}},"delete":{"parameters":[{"schema":{"type":"number","nullable":true},"required":false,"name":"id","in":"path"}],"responses":{"204":{"description":"已删除"},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"404":{"description":"memo 不存在","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/memos/{id}/pin":{"post":{"parameters":[{"schema":{"type":"number","nullable":true},"required":false,"name":"id","in":"path"}],"responses":{"200":{"description":"翻转后状态","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"content":{"type":"string"},"visibility":{"type":"string","enum":["public","private"]},"pinned":{"type":"boolean"},"rowStatus":{"type":"string","enum":["normal","archived"]},"tags":{"type":"array","items":{"type":"string"}},"resources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"memoId":{"type":"number","nullable":true},"name":{"type":"string"},"type":{"type":"string"},"size":{"type":"number"},"url":{"type":"string"},"createdTs":{"type":"number"}},"required":["id","uid","memoId","name","type","size","url","createdTs"]}},"createdTs":{"type":"number"},"updatedTs":{"type":"number"}},"required":["id","uid","content","visibility","pinned","rowStatus","tags","resources","createdTs","updatedTs"]}}}},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"404":{"description":"memo 不存在","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/memos/{id}/archive":{"post":{"parameters":[{"schema":{"type":"number","nullable":true},"required":false,"name":"id","in":"path"}],"responses":{"200":{"description":"翻转后状态","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"content":{"type":"string"},"visibility":{"type":"string","enum":["public","private"]},"pinned":{"type":"boolean"},"rowStatus":{"type":"string","enum":["normal","archived"]},"tags":{"type":"array","items":{"type":"string"}},"resources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"memoId":{"type":"number","nullable":true},"name":{"type":"string"},"type":{"type":"string"},"size":{"type":"number"},"url":{"type":"string"},"createdTs":{"type":"number"}},"required":["id","uid","memoId","name","type","size","url","createdTs"]}},"createdTs":{"type":"number"},"updatedTs":{"type":"number"}},"required":["id","uid","content","visibility","pinned","rowStatus","tags","resources","createdTs","updatedTs"]}}}},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"404":{"description":"memo 不存在","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/memos/export":{"get":{"parameters":[{"schema":{"type":"string","enum":["json","md"],"default":"json"},"required":false,"name":"format","in":"query"}],"responses":{"200":{"description":"全量导出（含归档；不含资源二进制，资源字段为元数据与引用路径）","content":{"application/json":{"schema":{"type":"object","properties":{"exportedAt":{"type":"number"},"total":{"type":"number"},"memos":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"content":{"type":"string"},"visibility":{"type":"string","enum":["public","private"]},"pinned":{"type":"boolean"},"rowStatus":{"type":"string","enum":["normal","archived"]},"tags":{"type":"array","items":{"type":"string"}},"resources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"memoId":{"type":"number","nullable":true},"name":{"type":"string"},"type":{"type":"string"},"size":{"type":"number"},"url":{"type":"string"},"createdTs":{"type":"number"}},"required":["id","uid","memoId","name","type","size","url","createdTs"]}},"createdTs":{"type":"number"},"updatedTs":{"type":"number"}},"required":["id","uid","content","visibility","pinned","rowStatus","tags","resources","createdTs","updatedTs"]}}},"required":["exportedAt","total","memos"]}},"text/markdown":{"schema":{"type":"string"}}}},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/public/resources/{id}/file":{"get":{"parameters":[{"schema":{"type":"number","nullable":true},"required":false,"name":"id","in":"path"}],"responses":{"200":{"description":"文件流"},"403":{"description":"资源不属于公开 memo","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/resources/upload":{"post":{"responses":{"201":{"description":"上传成功","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"memoId":{"type":"number","nullable":true},"name":{"type":"string"},"type":{"type":"string"},"size":{"type":"number"},"url":{"type":"string"},"createdTs":{"type":"number"}},"required":["id","uid","memoId","name","type","size","url","createdTs"]}}}},"400":{"description":"缺少文件或超过 10MB","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"404":{"description":"memoId 不存在","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/resources/{id}/meta":{"get":{"parameters":[{"schema":{"type":"number","nullable":true},"required":false,"name":"id","in":"path"}],"responses":{"200":{"description":"资源元信息","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"uid":{"type":"string"},"memoId":{"type":"number","nullable":true},"name":{"type":"string"},"type":{"type":"string"},"size":{"type":"number"},"url":{"type":"string"},"createdTs":{"type":"number"}},"required":["id","uid","memoId","name","type","size","url","createdTs"]}}}},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/resources/{id}/file":{"get":{"parameters":[{"schema":{"type":"number","nullable":true},"required":false,"name":"id","in":"path"}],"responses":{"200":{"description":"文件流（Content-Type 为原 mime）"},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/resources/{id}":{"delete":{"parameters":[{"schema":{"type":"number","nullable":true},"required":false,"name":"id","in":"path"}],"responses":{"204":{"description":"已删除"},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/tags":{"get":{"responses":{"200":{"description":"标签列表（按使用次数降序）","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"memoCount":{"type":"number"}},"required":["name","memoCount"]}},"total":{"type":"number"}},"required":["items","total"]}}}},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/memos/{id}/share":{"post":{"parameters":[{"schema":{"type":"number","nullable":true},"required":false,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"revoke":{"type":"boolean"}}}}}},"responses":{"200":{"description":"分享链接（撤销时 shareUrl 为 null）","content":{"application/json":{"schema":{"type":"object","properties":{"shareUrl":{"type":"string","nullable":true},"expiresTs":{"type":"number","nullable":true}},"required":["shareUrl","expiresTs"]}}}},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"403":{"description":"仅 public memo 可分享","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"404":{"description":"memo 不存在","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/migrate/import":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"batchId":{"type":"string","maxLength":64},"memos":{"type":"array","items":{"type":"object","properties":{"uid":{"type":"string","maxLength":64},"content":{"type":"string"},"visibility":{"type":"string","enum":["public","protected","private"],"default":"private"},"pinned":{"type":"integer","default":0},"rowStatus":{"type":"string","enum":["normal","archived"],"default":"normal"},"createdTs":{"type":"number"},"updatedTs":{"type":"number"}},"required":["content","createdTs"]},"minItems":1},"resources":{"type":"array","items":{"type":"object","properties":{"memoIndex":{"type":"integer","nullable":true,"minimum":0},"uid":{"type":"string","maxLength":64},"name":{"type":"string"},"type":{"type":"string"},"size":{"type":"integer","minimum":0},"dataBase64":{"type":"string"}},"required":["name","type"]},"default":[]}},"required":["memos"]}}}},"responses":{"201":{"description":"导入成功（含一致性报告）","content":{"application/json":{"schema":{"type":"object","properties":{"batchId":{"type":"string","nullable":true},"importedMemos":{"type":"number"},"importedResources":{"type":"number"},"skippedResources":{"type":"number"}},"required":["batchId","importedMemos","importedResources","skippedResources"]}}}},"400":{"description":"输入校验失败/超限","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"401":{"description":"未认证","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}},"409":{"description":"batchId 重复（幂等保护）","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}}}}