网站的三大标签,制作宣传图片的软件app,将网站做成logo怎么做,墨刀怎么做网站R2Cloud接口
机器人注册
请求和应答
注册是一个简单的 HTTP 接口#xff0c;根据机器人/用户信息注册#xff0c;创建一个新机器人。
请求 URL
URLhttp://ip/robot/regTypePOSTHTTP Version1.1Content-Typeapplication/json
请求参数
Param含义Rule是否必须缺省roboti…
R2Cloud接口
机器人注册
请求和应答
注册是一个简单的 HTTP 接口根据机器人/用户信息注册创建一个新机器人。
请求 URL
URLhttp://ip/robot/regTypePOSTHTTP Version1.1Content-Typeapplication/json
请求参数
Param含义Rule是否必须缺省robotid机器人唯一 IDmd 5 加密后的值必填NULLrobotPwd机器人密码md 5 加密后的值必填NULLnickName昵称不超过 32 个字符可选NULLemail邮箱符合 email 规范可选NULLuserName用户名称不超过 32 个字符可选NULL
服务示例
返回结果参数
名称含义规则说明code结果值0成功1失败2机器人存在
调用接口
{robotid:ced165163e51e06e01dc44c35fea3eaf,robotPwd:3687f20fbdfab8dd7e645f1e2f95268b,nickName:jarvis,email:Jarvisjoysonrobot.com,userName:gv
}返回值
{code:0
}处理逻辑 客户端提交的密码需要使用 md5 加密不能提供明文的密码。
机器人上线登录
请求和应答
登录根据机器人的登录信息连接到云平台。
请求URL
URLhttp://ip/robot/loginTypePOSTHTTP Version1.1Content-Typeapplication/json
请求参数
Param含义Rule是否必须缺省robotid机器人唯一 IDmd 5 加密后的值必填NULLrobotPwd机器人密码md 5 加密后的值必填NULL
服务示例
返回结果参数说明
名称含义规则说明code结果值0成功1失败token令牌每次上线后生成的token不一样后续请求需要带上token
调用接口
http://ip/robot/login
参数
{robotid:ced165163e51e06e01dc44c35fea3eaf,robotPwd:3687f20fbdfab8dd7e645f1e2f95268b
}
返回结果
{code:0,token:3a58ca22317e637797f8bcad5c047446
}处理逻辑 Token验证
Token 的中文有人翻译成 “令牌”意思就是你拿着这个令牌才能过一些关卡。
Token 是一个用户自定义的任意字符串。在成功提交了开发者自定义的这个字符串之后Token 的值 会保存到服务器后台。只有服务器和客户端前端知道这个字符串于是 Token 就成了这两者之间的 密钥它可以让服务器确认请求是来自客户端还是恶意的第三方。
使用基于 Token 的身份验证方法在服务端不需要存储用户的登录记录。大概的流程是这样的
客户端使用用户名和密码请求登录服务器收到请求验证用户名和密码验证成功后服务端生成一个Token这个Token可以存储在内存、磁盘、或者数据库里再把这个Token发送给客户端客户端收到Token以后可以存储起来比如放在Cookie或者Local Storage客户端每次向服务器请求资源时必须带着服务器签发的Token服务端收到请求然后去验证客户端请求里面带着的 Token如果验证成功就向客户端返回 请求的数据。
私有文件1
请求URL
URLhttp://ip/file/ownfile?cmdcountTypePOSTHTTP Version1.1Content-Typeapplication/json
请求参数
Param含义Rule是否必须缺省tokentoken同上必填NULLrobotid机器人唯一 ID不超过32个字符必填NULL
服务示例
返回结果参数说明
名称含义规则说明code结果值0验证成功1验证失败total文件数量
调用接口
http://ip/file/ownfile?cmdcount
参数
{token:3a58ca22317e637797f8bcad5c047446,robotid:ced165163e51e06e01dc44c35fea3eaf
}
返回结果
{total:1,code:0
}
没有文件返回
{total:0,code:0
}处理逻辑 私有文件2
请求URL
URLhttp://ip/file/ownfile?cmdnormalTypePOSTHTTP Version1.1Content-Typeapplication/json
请求参数
Param含义Rule是否必须缺省tokentoken同上必填NULLrobotid机器人唯一 ID不超过32个字符必填NULLcount文件个数私有文件数量0必填NULLstart开始位置必填NULL
服务示例
返回结果参数说明
名称含义规则说明files文件结果集“code”:0正常1失败,“count”:当前文件数量,“total”:私有文件数量,“robotid”:机器人唯一ID,“md5”:md5的值,“create_time”:创建时间,“file_name”:文件名,“share_status”:共享状态,“pv”:使用次数,“url”:URL,“size”:文件大小,“type”:文件类型
调用接口
http://ip/file/ownfile?cmdnormal
参数
{count:2,start:0,token:3a58ca22317e637797f8bcad5c047446,robotid:ced165163e51e06e01dc44c35fea3eaf
}
返回结果
{code:0,total:2,files:[{robotid:ced165163e51e06e01dc44c35fea3eaf,md5:6c5fa2864bb264c91167258b3e478fa0,create_time:2024-01-01 11:11:00,file_name:111.jpg,share_status:0,pv:1,url:http://ip/group1/M00/00/00/eBuDxWCfQHSATopyAAV8AJV_1mw866.111,size:1024,type:jpg}]
}处理逻辑 私有文件3
请求URL
URLhttp://ip/file/ownfile?cmdpvascTypePOSTHTTP Version1.1Content-Typeapplication/json
请求参数
Param含义Rule是否必须缺省tokentoken同上必填NULLrobotid机器人唯一 ID不超过32个字符必填NULLcount文件个数私有文件数量0必填NULLstart开始位置必填NULL
服务示例
返回结果参数说明
名称含义规则说明files文件结果集“code”:0正常1失败,“count”:当前文件数量,“total”:私有文件数量,“robotid”:机器人唯一ID,“md5”:md5的值,“create_time”:创建时间,“file_name”:文件名,“share_status”:共享状态,“pv”:使用次数,“url”:URL,“size”:文件大小,“type”:文件类型
调用接口
http://ip/file/ownfile?cmdnormal
参数
{count:2,start:0,token:3a58ca22317e637797f8bcad5c047446,robotid:ced165163e51e06e01dc44c35fea3eaf
}
返回结果
{code:0,total:2,files:[{robotid:ced165163e51e06e01dc44c35fea3eaf,md5:6c5fa2864bb264c91167258b3e478fa0,create_time:2024-01-01 11:11:00,file_name:111.jpg,share_status:0,pv:1,url:http://ip/group1/M00/00/00/eBuDxWCfQHSATopyAAV8AJV_1mw866.111,size:1024,type:jpg}]
}处理逻辑 私有文件4
请求URL
URLhttp://ip/file/ownfile?cmdpvdescTypePOSTHTTP Version1.1Content-Typeapplication/json
请求参数
Param含义Rule是否必须缺省tokentoken同上必填NULLrobotid机器人唯一 ID不超过32个字符必填NULLcount文件个数私有文件数量0必填NULLstart开始位置必填NULL
服务示例
返回结果参数说明
名称含义规则说明files文件结果集“code”:0正常1失败,“count”:当前文件数量,“total”:私有文件数量,“robotid”:机器人唯一ID,“md5”:md5的值,“create_time”:创建时间,“file_name”:文件名,“share_status”:共享状态,“pv”:使用次数,“url”:URL,“size”:文件大小,“type”:文件类型
调用接口
http://ip/file/ownfile?cmdnormal
参数
{count:2,start:0,token:3a58ca22317e637797f8bcad5c047446,robotid:ced165163e51e06e01dc44c35fea3eaf
}
返回结果
{code:0,total:2,files:[{robotid:ced165163e51e06e01dc44c35fea3eaf,md5:6c5fa2864bb264c91167258b3e478fa0,create_time:2024-01-01 11:11:00,file_name:111.jpg,share_status:0,pv:1,url:http://ip/group1/M00/00/00/eBuDxWCfQHSATopyAAV8AJV_1mw866.111,size:1024,type:jpg}]
}处理逻辑 上传文件md5
用于秒传文件的请求。
文件上传的时候
先调用md5接口判断服务器是否有该文件如果md5成功则说明服务器有该文件不需要upload如果不成功则调用upload。
请求URL
URLhttp://ip/file/md5TypePOSTHTTP Version1.1Content-Typeapplication/json
请求参数
Param含义Rule是否必须缺省tokentoken同上必填NULLrobotid机器人唯一 ID不超过32个字符必填NULLmd5md5值不超过32个字符必填NULLfilename文件名称不超过128个字符必填NULL
服务示例
返回结果参数说明
名称含义规则说明code结果值0: 秒传成功1: 秒传失败4: token 校验失败5文件已存在
调用接口
http://ip/file/md5
参数
{filename:ui_bottongroup.h,md5:a89390d867d5da18c8b1a95908d7c653,token:3a58ca22317e637797f8bcad5c047446,robotid:ced165163e51e06e01dc44c35fea3eaf
}
返回结果
{code:0
}处理逻辑
每个文件都有一个唯一的 MD5 值比如 2bf8170b42cc7124b04a8886c83a9c6f就好比每个人的指 纹都是唯一的一样效验 MD5 就是用来确保文件在传输过程中未被修改过。
客户端在上传文件之前先将文件的md5码上传到服务器服务器判断是否存在这个md5码如果存在说明文件存在则此文件无需再次上传在此文件的计数器上加1说明文件多了一个用户共用如果服务器没有这个md5码则说明。传的是新文件需要上传 上传文件upload
请求URL
URLhttp://ip/file/uploadTypePOSTHTTP Version1.1Content-Typeapplication/json
返回结果参数说明
名称含义规则说明code结果值0: 秒传成功1: 上传失败
处理逻辑 共享/删除1
请求 URL
URLhttp://ip/file/dealfile?cmdshareTypePOSTHTTP Version1.1Content-Typeapplication/json
请求参数
Param含义Rule是否必须缺省tokentoken同上必填NULLrobotid机器人唯一 ID不超过32个字符必填NULLmd5md5值不超过32个字符必填NULLfilename文件名称不超过128个字符必填NULL
服务示例
返回结果参数说明
名称含义规则说明code结果值0: 成功1: 失败3: 另外的机器人已经共享4: token 验证失败
调用接口
http://ip/file/dealfile?cmdpv
参数
{filename:Makefile,md5:602fdf30db2aacf517badf4565124f51,token:3a58ca22317e637797f8bcad5c047446,robotid:ced165163e51e06e01dc44c35fea3eaf
}
返回结果
{code:0
}处理逻辑 共享/删除文件2
请求URL
URLhttp://ip/file/dealfile?cmddelTypePOSTHTTP Version1.1Content-Typeapplication/json
请求参数
Param含义Rule是否必须缺省tokentoken同上必填NULLrobotid机器人唯一 ID不超过32个字符必填NULLmd5md5值不超过32个字符必填NULLfilename文件名称不超过128个字符必填NULL
服务示例
返回结果参数说明
名称含义规则说明code结果值0: 成功1: 失败
调用接口
http://ip/file/dealfile?cmddel
参数
{filename:Makefile,md5:602fdf30db2aacf517badf4565124f51,token:3a58ca22317e637797f8bcad5c047446,robotid:ced165163e51e06e01dc44c35fea3eaf
}
返回结果
{code:0
}处理逻辑 先判断此文件是否已经分享判断集合有没有这个文件如果有说明别人已经分享此文件(RDS操作)如果集合没有此元素可能因为 redis 中没有记录再从 SQL中查询如果 SQL也没有说 明真没有(SQL操作)如果 SQL有记录而 RDS没有记录那么分享文件处理只需要处理 SQL(SQL操作)如果 RDS有记录SQL和 RDS都需要处理删除相关记录
取消共享
请求URL
URLhttp://ip/file/dealsharefile?cmdcancelTypePOSTHTTP Version1.1Content-Typeapplication/json
请求参数
Param含义Rule是否必须缺省robotid机器人唯一 ID不超过32个字符必填NULLmd5md5值不超过32个字符必填NULLfilename文件名称不超过128个字符必填NULL
服务示例
返回结果参数说明
名称含义规则说明code结果值0: 成功1: 失败
调用接口
http://ip/file/dealsharefile?cmdcancel
参数
{filename:ui_buttongroup.hmd5:a89390d867d5da18c8b1a95908d7c653,robotid:ced165163e51e06e01dc44c35fea3eaf
}
返回结果
{code:0
}处理逻辑 查询共享文件的数量如果共享文件数量为1则删除共享文件数量对应的行如果共享文件数量1则更新共享数量文件-1。
转存文件
请求URL
URLhttp://ip/file/dealsharefile?cmdsaveTypePOSTHTTP Version1.1Content-Typeapplication/json
请求参数
Param含义Rule是否必须缺省robotid机器人唯一 ID不超过32个字符必填NULLmd5md5值不超过32个字符必填NULLfilename文件名称不超过128个字符必填NULL
服务示例
返回结果参数说明
名称含义规则说明code结果值0: 成功1: 失败5: 文件存在
http://ip/file/dealsharefile?cmdsave
参数
{filename:ui_buttongroup.hmd5:a89390d867d5da18c8b1a95908d7c653,robotid:ced165163e51e06e01dc44c35fea3eaf
}
返回结果
{code:0
}处理逻辑 先查询是个人文件列表是否已经存在该文件增加 file_info 表的 count 计数表是多一个人保存了该文件个人的 user_file_list 增加一条文件记录更新个人的 user_file_count。
更新共享文件下载计数
请求URL
URLhttp://ip/file/dealsharefile?cmdsaveTypePOSTHTTP Version1.1Content-Typeapplication/json
请求参数
Param含义Rule是否必须缺省robotid机器人唯一 ID不超过32个字符必填NULLmd5md5值不超过32个字符必填NULLfilename文件名称不超过128个字符必填NULL
服务示例
返回结果参数说明
名称含义规则说明code结果值0: 成功1: 失败5: 文件存在
http://ip/file/dealsharefile?cmdpv
参数
{filename:ui_buttongroup.hmd5:a89390d867d5da18c8b1a95908d7c653,robotid:ced165163e51e06e01dc44c35fea3eaf
}
返回结果
{code:0
}处理逻辑 更新share_file_list的pv值更新RDS的FILE_PUBLIC_ZSET。
分享文件
请求URL
URLhttp://ip/file/sharefile?cmdshareTypePOSTHTTP Version1.1Content-Typeapplication/json
请求参数
Param含义Rule是否必须缺省tokentoken同上必填NULLrobotid机器人唯一 ID不超过32个字符必填NULLmd5md5值不超过32个字符必填NULLfilename文件名称不超过128个字符必填NULL
服务示例
返回结果参数说明
名称含义规则说明code结果值0: 成功1: 失败4: token验证失败urlmd5分享文件标识取消也要
调用接口
http://ip/file/sharefile?cmdshare
参数
{filename:ui_buttongroup.hmd5:a89390d867d5da18c8b1a95908d7c653,token:3a58ca22317e637797f8bcad5c047446,robotid:ced165163e51e06e01dc44c35fea3eaf
}
返回结果
{code:0,urlmd5:602fdf30db2aacf517badf4565121234
}处理逻辑 新建分组
新建一个MQTT的Topic用于协作。
请求URL
URLhttp://ip/msg/newgroupTypePOSTHTTP Version1.1Content-Typeapplication/json
请求参数
Param含义Rule是否必须缺省tokentoken同上必填NULLrobotid机器人唯一 ID不超过32个字符必填NULLmaxsize同组最大数量1必填NULL
服务示例
返回结果参数说明
名称含义规则说明code结果值0: 成功1: 失败4: token验证失败topic加密后的topic失败为空
调用接口
http://ip/file/msg/newgroup
参数
{token:3a58ca22317e637797f8bcad5c047446,robotid:ced165163e51e06e01dc44c35fea3eaf,maxsize:10
}
返回结果
{code:0,topic:614b0c23f5f4cd3a68ba5581e2169df3
}处理逻辑 释放分组
请求 URL
URLhttp://ip/msg/freegroupTypePOSTHTTP Version1.1Content-Typeapplication/json
请求参数
Param含义Rule是否必须缺省tokentoken同上必填NULLrobotid机器人唯一 ID不超过32个字符必填NULLtopic加密后的topic不超过32个字符必填NULL
服务示例
返回结果参数说明
名称含义规则说明code结果值0: 成功1: 失败4: token 验证失败5: 非topic管理员
调用接口
http://ip/file/msg/freegroup
参数
{token:3a58ca22317e637797f8bcad5c047446,robotid:ced165163e51e06e01dc44c35fea3eaf,topic:614b0c23f5f4cd3a68ba5581e2169df3
}
返回结果
{code:0,
}处理逻辑
