美术大家客户端接口v1.0.docVIP

美术大家客户端接口文档v1.0 目录 美术大家客户端接口文档v1.0 1 目录 1 接口约定 2 举例 2 用户模块 2 艺术家登录 2 用户第三方账号登录 3 退出登录 4 关注艺术家 4 取消关注艺术家 4 给艺术家留言 5 我关注的艺术家列表 5 艺术家 6 获取艺术家列表（分组全部） 6 获取艺术家详情 7 获取艺术家作品集 7 作品 8 获取分类列表（推荐最新） 8 获取分类下作品列表 9 作品详情 9 评论作品 10 收藏作品 10 作品评论列表 11 艺术圈 12 艺术圈列表 12 未读消息列表 13 忽略全部消息 15 发表艺术圈 15 艺术圈回复列表 16 回复具体艺术圈内容 16 掌上展厅 17 展厅列表 17 作品详情 18 收藏作品 19 画廊 19 画廊列表 19 画廊作品列表 21 作品详情 22 接口约定 接口使用http协议，POST方式提交，内容编码为UTF-8, 接口返回值按标准json格式(json格式,请参照相关文档资料)或者字符串（看具体接口说明） 名称 name 类型 必填 默认值 附加说明 接口地址 url string 必填 接口名 name string 必填 接口名严格控制大小写 参数 parameter string 选填 根据说明是否需要传递参数 举例 请求： url: :81/paint/ name: Test/Index parameter:id=1name=Tom 返回值： {state:200,msg:\u6210\u529f} 接口地址： :81/paint/ 用户模块 艺术家登录 描述：艺术家登录接口。 接口名：User/Login 附加参数（无） 名称 name 类型 必填 默认值 附加说明 用户名 username string 是 deviceToken 密码 password string 是 返回值(json) 名称 name 类型 附加说明 分组列表 state int 200:登录成功，300：无该艺术家账号，301：账号密码不匹配 分组列表 data 若state为300或301，则为错误信息，若为200，则为用户信息数组，格式如下 id ID int username 用户名 string avatar 头像 string role 角色 int，值固定为2 用户第三方账号登录 描述：普通用户使用第三方平台登录。 接口名：User/SynLogin 附加参数（无） 名称 name 类型 必填 默认值 附加说明 用户名 username string 是 deviceToken string 头像 pic string 否 第三方标识 syn_id bigint 是 第三方类型 syn_type int 是 1：新浪微博，2：QQ 简介 syn_note string 否 返回值(json) 名称 name 类型 附加说明 分组列表 state int 200:登录成功，300：登录失败 分组列表 data 若state为300，则为错误信息，若为200，则为用户信息数组，格式如下 id ID int username 用户名 string avatar 头像 string role 角色 int，值固定为3 退出登录 描述：普通用户和艺术家均使用该退出接口。 接口名：User/Logout 附加参数（无） 名称 name 类型 必填 默认值 附加说明 用户名 username string 是 角色 role int 是 2：艺术家，3：普通用户 返回值(string) 名称 name 类型 附加说明 int 200：退出成功，300：退出失败 关注艺术家 描述：用户关注某艺术家。 接口名：User/FollowArtist 附加参数 名称 name 类型 必填 默认值 附加说明 艺术家ID id int 是 用户ID userid int 是 用户角色 role int 是 2：艺术家，3：普通会员 返回值(json) 名称 name 类型 附加说明 状态 state int 200：关注成功，300：关注失败 返回信息 msg string 若失败，则为失败信息 关注数 count int 关注之后该艺术家被关注数 取消关注艺术家 描述：用户取消关注某艺术家。 接口名：User/DelFollowArtist 附加参数 名称 name 类型 必填 默认值 附加说明 艺术家ID id int 是