{ "swagger": "2.0", "info": { "title": "blocks.proto", "version": "version not set" }, "tags": [ { "name": "Album" }, { "name": "Bookmark" }, { "name": "Disk" }, { "name": "Note" }, { "name": "Private" }, { "name": "Share" }, { "name": "Space" } ], "consumes": [ "application/json" ], "produces": [ "application/json" ], "paths": {}, "definitions": { "cloudCloudAlbumItem": { "type": "object", "properties": { "id": { "type": "string", "format": "uint64" }, "identity": { "type": "string" }, "name": { "type": "string", "title": "相册名称" }, "description": { "type": "string", "title": "相册描述" }, "coverPhoto": { "type": "string", "title": "封面照片URL" }, "isPrivate": { "type": "boolean", "title": "是否私有" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "photos": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudCloudPhotoItem" }, "description": "相册下的照片", "title": "关联关系" } }, "title": "相册模型" }, "cloudCloudBookmarkItem": { "type": "object", "properties": { "id": { "type": "string", "format": "uint64" }, "identity": { "type": "string" }, "title": { "type": "string", "title": "标题" }, "url": { "type": "string", "title": "网址" }, "description": { "type": "string", "title": "描述" }, "category": { "type": "string", "title": "分类" }, "tags": { "type": "string", "title": "标签" }, "icon": { "type": "string", "title": "网站图标URL" }, "isPrivate": { "type": "boolean", "title": "是否私有" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "title": "网址收藏夹模型" }, "cloudCloudDiskDirItem": { "type": "object", "properties": { "id": { "type": "string", "format": "uint64" }, "identity": { "type": "string" }, "parentId": { "type": "string", "format": "uint64", "title": "支持嵌套目录" }, "name": { "type": "string", "title": "目录名称" }, "path": { "type": "string", "title": "完整路径" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "parent": { "$ref": "#/definitions/cloudCloudDiskDirItem", "description": "父级目录", "title": "自关联" }, "subdirectories": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudCloudDiskDirItem" }, "title": "子级目录" }, "files": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudCloudDiskFileItem" }, "title": "文件" } }, "title": "云盘目录模型" }, "cloudCloudDiskFileItem": { "type": "object", "properties": { "id": { "type": "string", "format": "uint64" }, "identity": { "type": "string" }, "directoryId": { "type": "string", "format": "uint64", "title": "文件所属目录" }, "name": { "type": "string", "title": "文件名" }, "originalName": { "type": "string", "title": "原始文件名" }, "size": { "type": "string", "format": "int64", "title": "文件大小 (bytes)" }, "mimeType": { "type": "string", "title": "文件类型" }, "storagePath": { "type": "string", "title": "实际存储路径" }, "hash": { "type": "string", "title": "文件哈希,用于去重" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "directory": { "$ref": "#/definitions/cloudCloudDiskDirItem", "description": "文件所属目录", "title": "关联关系" } }, "title": "云盘文件" }, "cloudCloudNoteItem": { "type": "object", "properties": { "id": { "type": "string", "format": "uint64" }, "identity": { "type": "string" }, "title": { "type": "string", "title": "标题" }, "content": { "type": "string", "title": "内容" }, "category": { "type": "string", "title": "分类" }, "tags": { "type": "string", "title": "标签,逗号分隔" }, "isMarkdown": { "type": "boolean", "title": "是否是markdown格式" }, "isPinned": { "type": "boolean", "title": "是否是置顶" }, "isPrivate": { "type": "boolean", "title": "是否是私有" }, "views": { "type": "integer", "format": "int32", "title": "浏览次数" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "attachments": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudNoteAttachmentItem" }, "title": "关联关系" } }, "title": "知识笔记模型" }, "cloudCloudPhotoItem": { "type": "object", "properties": { "id": { "type": "string", "format": "uint64" }, "identity": { "type": "string" }, "albumId": { "type": "string", "format": "uint64", "title": "专辑ID" }, "title": { "type": "string", "title": "照片标题" }, "description": { "type": "string", "title": "照片描述" }, "filePath": { "type": "string", "title": "文件路径" }, "fileSize": { "type": "string", "format": "int64", "title": "文件大小" }, "mimeType": { "type": "string", "title": "文件类型" }, "width": { "type": "integer", "format": "int32", "title": "图片宽度" }, "height": { "type": "integer", "format": "int32", "title": "图片高度" }, "takenAt": { "type": "string", "title": "拍摄时间" }, "location": { "type": "string", "title": "拍摄地点" }, "tags": { "type": "string", "title": "标签,逗号分隔" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "album": { "$ref": "#/definitions/cloudCloudAlbumItem", "title": "关联关系" } }, "title": "照片模型" }, "cloudCloudPrivateItem": { "type": "object", "properties": { "id": { "type": "string", "format": "uint64" }, "identity": { "type": "string" }, "dataType": { "type": "string", "description": "数据类型: password, card, document, etc." }, "title": { "type": "string", "title": "标题" }, "description": { "type": "string", "title": "描述" }, "data": { "type": "string", "title": "加密存储的实际数据" }, "isEncrypted": { "type": "boolean", "title": "是否已加密" }, "tags": { "type": "string", "title": "标签" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "title": "个人隐私数据模型" }, "cloudCloudShareItem": { "type": "object", "properties": { "id": { "type": "string", "format": "uint64" }, "identity": { "type": "string" }, "shareType": { "type": "string", "description": "file, album, note, etc." }, "resourceId": { "type": "string", "format": "uint64", "title": "对应资源的ID" }, "shareToken": { "type": "string", "title": "分享令牌" }, "password": { "type": "string", "title": "可选分享密码" }, "expiresAt": { "type": "string", "title": "过期时间" }, "viewCount": { "type": "integer", "format": "int32", "title": "浏览次数" }, "downloadCount": { "type": "integer", "format": "int32", "title": "下载次数" }, "isPublic": { "type": "boolean", "title": "是否公开" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "title": "分享系统模型" }, "cloudCloudSpace": { "type": "object", "properties": { "id": { "type": "string", "format": "uint64" }, "identity": { "type": "string" }, "totalStorage": { "type": "string", "format": "int64", "title": "总存储空间" }, "usedStorage": { "type": "string", "format": "int64", "title": "已用存储空间" }, "maxStorage": { "type": "string", "format": "int64", "title": "最大存储空间" }, "fileCount": { "type": "integer", "format": "int32", "title": "文件数量" }, "albumCount": { "type": "integer", "format": "int32", "title": "相册数量" }, "photoCount": { "type": "integer", "format": "int32", "title": "照片数量" }, "noteCount": { "type": "integer", "format": "int32", "title": "笔记数量" }, "bookmarkCount": { "type": "integer", "format": "int32", "title": "书签数量" }, "privateCount": { "type": "integer", "format": "int32", "title": "私有数量" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "cloudDiskDirs": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudCloudDiskDirItem" }, "description": "关联云盘目录", "title": "关联关系" }, "cloudAlbums": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudCloudAlbumItem" }, "title": "关联相册" }, "cloudNotes": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudCloudNoteItem" }, "title": "关联笔记" }, "cloudBookmarks": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudCloudBookmarkItem" }, "title": "关联书签" }, "cloudPrivate": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudCloudPrivateItem" }, "title": "关联私有数据" }, "cloudShares": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudCloudShareItem" }, "title": "关联分享" } }, "title": "系统统计和配置模型" }, "cloudListAlbumsResponse": { "type": "object", "properties": { "albums": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudCloudAlbumItem" } }, "total": { "type": "string", "format": "int64" } } }, "cloudListBookmarksResponse": { "type": "object", "properties": { "bookmarks": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudCloudBookmarkItem" } }, "total": { "type": "string", "format": "int64" } } }, "cloudListDirsResponse": { "type": "object", "properties": { "dirs": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudCloudDiskDirItem" } }, "total": { "type": "string", "format": "int64" } }, "title": "请求消息定义" }, "cloudListFilesResponse": { "type": "object", "properties": { "files": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudCloudDiskFileItem" } }, "total": { "type": "string", "format": "int64" } } }, "cloudListNotesResponse": { "type": "object", "properties": { "notes": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudCloudNoteItem" } }, "total": { "type": "string", "format": "int64" } } }, "cloudListPhotosResponse": { "type": "object", "properties": { "photos": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudCloudPhotoItem" } }, "total": { "type": "string", "format": "int64" } } }, "cloudListPrivateDataResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudCloudPrivateItem" } }, "total": { "type": "string", "format": "int64" } } }, "cloudListSharesResponse": { "type": "object", "properties": { "shares": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/cloudCloudShareItem" } }, "total": { "type": "string", "format": "int64" } } }, "cloudNoteAttachmentItem": { "type": "object", "properties": { "id": { "type": "string", "format": "uint64" }, "noteId": { "type": "string", "format": "uint64", "title": "笔记ID" }, "fileName": { "type": "string", "title": "文件名" }, "filePath": { "type": "string", "title": "文件路径" }, "fileSize": { "type": "string", "format": "int64", "title": "文件大小" }, "mimeType": { "type": "string", "title": "文件类型" }, "createdAt": { "type": "string", "title": "创建时间" } }, "title": "笔记附件模型" }, "cloudStatusReply": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "title": "状态码" }, "message": { "type": "string", "title": "状态说明" }, "details": { "type": "string", "title": "数据" }, "timeseq": { "type": "string", "format": "int64", "title": "响应时间序列" } }, "title": "状态回复" }, "protobufAny": { "type": "object", "properties": { "@type": { "type": "string" } }, "additionalProperties": {} }, "rpcStatus": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "details": { "type": "array", "items": { "type": "object", "$ref": "#/definitions/protobufAny" } } } } } }