{"openapi":"3.0.1","info":{"title":"CoolNote API","description":"CoolNote REST API。文档：/doc.html（Knife4j）。运营台：/admin 或 /coolnote/ops/console/login.html。分组：all / client / admin / legacy。","version":"v1"},"servers":[{"url":"/","description":"relative"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Legacy分享","description":"旧版 /say/api 分享接口，表单参数 + BasResponse 形态"},{"name":"Legacy认证","description":"旧版 /say/api 认证接口（表单/查询参数）"}],"paths":{"/say/api/getShare":{"get":{"tags":["Legacy分享"],"summary":"获取分享列表（aid+type 筛选；state 默认 1）","operationId":"getShare","parameters":[{"name":"aid","in":"query","description":"应用标识","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","description":"分享类型","required":false,"schema":{"type":"string"}},{"name":"state","in":"query","description":"状态，默认 1","required":false,"schema":{"type":"string"}},{"name":"ti","in":"query","description":"时间戳校验参数","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResultVoid"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}}}},"post":{"tags":["Legacy分享"],"summary":"获取分享列表（aid+type 筛选；state 默认 1）","operationId":"getShare_1","parameters":[{"name":"aid","in":"query","description":"应用标识","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","description":"分享类型","required":false,"schema":{"type":"string"}},{"name":"state","in":"query","description":"状态，默认 1","required":false,"schema":{"type":"string"}},{"name":"ti","in":"query","description":"时间戳校验参数","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResultVoid"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}}}}},"/say/api/delectShare":{"get":{"tags":["Legacy分享"],"summary":"删除一条分享","operationId":"delectShare","parameters":[{"name":"id","in":"query","description":"分享 ID","required":false,"schema":{"type":"string"}},{"name":"ti","in":"query","description":"时间戳校验参数","required":false,"schema":{"type":"string"}},{"name":"aid","in":"query","description":"应用标识","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResultVoid"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}}}},"post":{"tags":["Legacy分享"],"summary":"删除一条分享","operationId":"delectShare_1","parameters":[{"name":"id","in":"query","description":"分享 ID","required":false,"schema":{"type":"string"}},{"name":"ti","in":"query","description":"时间戳校验参数","required":false,"schema":{"type":"string"}},{"name":"aid","in":"query","description":"应用标识","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResultVoid"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}}}}},"/say/api/addShare":{"get":{"tags":["Legacy分享"],"summary":"添加分享内容","operationId":"addShare","parameters":[{"name":"type","in":"query","description":"分享类型","required":false,"schema":{"type":"string"}},{"name":"aid","in":"query","description":"应用标识","required":false,"schema":{"type":"string"}},{"name":"data","in":"query","description":"分享数据","required":false,"schema":{"type":"string"}},{"name":"ti","in":"query","description":"时间戳校验参数","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResultVoid"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}}}},"post":{"tags":["Legacy分享"],"summary":"添加分享内容","operationId":"addShare_1","parameters":[{"name":"type","in":"query","description":"分享类型","required":false,"schema":{"type":"string"}},{"name":"aid","in":"query","description":"应用标识","required":false,"schema":{"type":"string"}},{"name":"data","in":"query","description":"分享数据","required":false,"schema":{"type":"string"}},{"name":"ti","in":"query","description":"时间戳校验参数","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResultVoid"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}}}}},"/say/api/UpShareState":{"get":{"tags":["Legacy分享"],"summary":"更新分享状态为已生效(1)","operationId":"upShareState","parameters":[{"name":"id","in":"query","description":"分享 ID","required":false,"schema":{"type":"string"}},{"name":"ti","in":"query","description":"时间戳校验参数","required":false,"schema":{"type":"string"}},{"name":"aid","in":"query","description":"应用标识","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResultVoid"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}}}},"post":{"tags":["Legacy分享"],"summary":"更新分享状态为已生效(1)","operationId":"upShareState_1","parameters":[{"name":"id","in":"query","description":"分享 ID","required":false,"schema":{"type":"string"}},{"name":"ti","in":"query","description":"时间戳校验参数","required":false,"schema":{"type":"string"}},{"name":"aid","in":"query","description":"应用标识","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResultVoid"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}}}}},"/say/api/UpShareNum":{"get":{"tags":["Legacy分享"],"summary":"分享使用次数 +1","operationId":"upShareNum","parameters":[{"name":"id","in":"query","description":"分享 ID","required":false,"schema":{"type":"string"}},{"name":"ti","in":"query","description":"时间戳校验参数","required":false,"schema":{"type":"string"}},{"name":"aid","in":"query","description":"应用标识","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResultVoid"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}}}},"post":{"tags":["Legacy分享"],"summary":"分享使用次数 +1","operationId":"upShareNum_1","parameters":[{"name":"id","in":"query","description":"分享 ID","required":false,"schema":{"type":"string"}},{"name":"ti","in":"query","description":"时间戳校验参数","required":false,"schema":{"type":"string"}},{"name":"aid","in":"query","description":"应用标识","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResultVoid"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}}}}},"/say/api/login":{"get":{"tags":["Legacy认证"],"summary":"登录（兼容）","operationId":"login","parameters":[{"name":"email","in":"query","description":"邮箱","required":false,"schema":{"type":"string"}},{"name":"code","in":"query","description":"验证码","required":false,"schema":{"type":"string"}},{"name":"pass","in":"query","description":"密码","required":false,"schema":{"type":"string"}},{"name":"aid","in":"query","description":"应用标识","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResultVoid"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}}}},"post":{"tags":["Legacy认证"],"summary":"登录（兼容）","operationId":"login_1","parameters":[{"name":"email","in":"query","description":"邮箱","required":false,"schema":{"type":"string"}},{"name":"code","in":"query","description":"验证码","required":false,"schema":{"type":"string"}},{"name":"pass","in":"query","description":"密码","required":false,"schema":{"type":"string"}},{"name":"aid","in":"query","description":"应用标识","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResultVoid"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}}}}},"/say/api/getCodeByEmail":{"get":{"tags":["Legacy认证"],"summary":"发送邮箱验证码（兼容）","operationId":"getCodeByEmail","parameters":[{"name":"toEmail","in":"query","description":"收件邮箱","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResultVoid"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}}}},"post":{"tags":["Legacy认证"],"summary":"发送邮箱验证码（兼容）","operationId":"getCodeByEmail_1","parameters":[{"name":"toEmail","in":"query","description":"收件邮箱","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Not Found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResultVoid"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}}}}}},"components":{"schemas":{"ApiResultVoid":{"type":"object","properties":{"code":{"type":"integer","description":"业务状态码：200 成功，201 失败，202 未授权","format":"int32","example":200},"message":{"type":"string","description":"提示信息","example":"ok"},"data":{"type":"object","description":"业务数据"},"time":{"type":"integer","description":"响应时间戳（毫秒）","format":"int64","example":1710000000000}},"description":"统一 API 响应包装"},"LegacyResponse":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"msg":{"type":"string"},"data":{"type":"object"},"time":{"type":"integer","format":"int64"}}}},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"x-openapi":{"x-setting":{"customCode":200,"language":"zh-CN","enableSwaggerModels":true,"swaggerModelName":"Swagger Models","enableReloadCacheParameter":false,"enableAfterScript":true,"enableDocumentManage":true,"enableVersion":false,"enableRequestCache":true,"enableFilterMultipartApis":false,"enableFilterMultipartApiMethodType":"POST","enableHost":false,"enableHostText":"","enableDynamicParameter":false,"enableDebug":true,"enableFooter":false,"enableFooterCustom":false,"enableSearch":true,"enableOpenApi":true,"enableHomeCustom":false,"enableGroup":true,"enableResponseCode":true},"x-markdownFiles":[]}}