[关闭]
@15311494814 2016-06-20T10:42:58.000000Z 字数 8629 阅读 486

艺人表Controller

controller: - ArtistController

1, 增加艺人资料

功能 : 添加用户名称，艺名等个人资料
路径 ： POST rest/artist
body : 

  1. {
  2.  "name":"lichua121n",                    
  3.  "stagename":"123456", 
  4.  "ename":"jack",
  5.  "class1":"演员，导演",                  
  6.  "class2":"电影演员，电视剧导演",        
  7.  "sex":"1",                             
  8.  "birthday":"1990-01-28",               
  9.  "nation":"汉族",                       
  10.  "state":"中国",                        
  11.  "attribute":"身高|123,三围|12/12/12,体重|75kg", （形式待定）
  12.  "workingtime":"2000-05-01"（待定）,      
  13.  "flags":"70后,蜀黎",
  14.  "introduction":"aa",
  15.  "headfileid":"qweqeqwew2131231", 
  16.  "viewfileids":"wqeqwe213,wqeqwe213,qwe21313",
  17.  "mobile":"12345678901",
  18.  "email":"10000@qq.com",            
  19.  "area":"北京",         
  20.  "address":"三里屯" 
  21. }

正确返回：

  1. {
  2.  "statusCode" : "000000",
  3.  "result": 
  4.           {
  5.            "uuid":"132wq132wq13weqwe23e",
  6.            "name":"lichua121n",                    
  7.            "stagename":"123456", 
  8.            "ename":"jack",
  9.            "class1":"演员，导演",                  
  10.            "class2":"电影演员，电视剧导演",        
  11.            "sex":"1",                             
  12.            "birthday":"1990-01-28",               
  13.            "nation":"汉族",                       
  14.            "state":"中国",                        
  15.            "attribute":"身高|123,三围|12/12/12,体重|75kg", (待定)
  16.            "idtype":"",
  17.            "idnum":"",
  18.            "workingtime":"2000-05-01", (待定)     
  19.            "flags":"70后,蜀黎",
  20.            "introduction":"aa",
  21.            "mobile":"12345678901",
  22.            "email":"10000@qq.com",
  23.            "headfileid":"qweqeqwew2131231", 
  24.             "viewfileids":"wqeqwe213,wqeqwe213,qwe21313",
  25.            "headfileidPath":"artist/2016/06/16/image/qweq31q32qe231s31qwe2_20160616142432.jpg", 
  26.            "viewfileidsPath":"artist/2016/06/16/image/qweq31q32qe231s31qwe2_20160616142432.jpg,
  27.                           artist/2016/06/16/image/qweq31q32qe231s31qwe2_20160616142432.jpg,
  28.                           artist/2016/06/16/image/qweq31q32qe231s31qwe2_20160616142432.jpg",     
  29.            "area":"北京",         
  30.            "address":"三里屯",
  31.            "createtime":"2001-01-28 12:56:32",
  32.            "company":"华视",
  33.            "certstatus":"1",
  34.            "serialcode":"13214564",
  35.            "status":"0",
  36.            "audittime":"",
  37.            "auditresult":""
  38.           }
  39. "error":""
  40. }

jsonMap | 传递参数json用来保存页面数据

数据参数 必须 说明
name 否 姓名
stagename 否 艺名
ename 否 英文姓名
class1 否 一级分类
class2 否 二级分类
sex 否 性别(1,男.2，女.3，保密)
birthday 否 出生日期(yyyy-MM-dd)
nation 否 民族
state 否 国家
attribute 否 属性信息(属性集,逗号隔开)
workingtime 否 从业时间
flags 否 个性标签(逗号隔开)
introduction 否 简介
headfileid 头像ID
viewfileids 展示大图的ID（逗号隔开)
mobile 否 手机
email 否 邮箱
area 否 所在区域
address 否 地址
@1正确返回值 说明
statusCode 状态码,正常为 000000
result
uuid 艺人id
name 姓名
stagename 艺名
ename 英文姓名
class1 一级分类
class2 二级分类
sex 性别(1,男.2，女.3，保密)
birthday 出生日期(yyyy-MM-dd)
nation 民族
state 国家
attribute 属性信息(属性集,逗号隔开)
idtype 证件类型
idnum 证件号码
workingtime 从业时间
flags 个性标签(逗号隔开)
introduction 简介
mobile 手机
email 邮箱
headfileid 头像 的文件ID
viewfileids 展示大图的文件ID集（逗号隔开)
headfileidPath 头像 的相对文件路径
viewfileidsPath 展示大图的相对文件路径（逗号隔开)

area | 所在区域
address | 地址
createtime | 创建时间 YYYY-MM-DD HH:mm:ss
company | 艺人所在公司
certstatus | 认证 (0:未认证 1：认证中 2：已认证 3：认证失败)
serialcode | 随机编号 （为通告报名使用）
status | 状态 (0：正常 1：封号)
audittime | 审核时间
auditresult | 审核结果 （异常）
error | ""

### 2, 变更艺人头像信息

功能 : 添加用户名称，艺名等个人资料
路径 ： PUT rest/artist/image?id=艺人ID
body : 

  1. {
  2.  "headfileid":"这是头像ID",
  3.  "viewfileids":"这是大图ID"
  4. }

正确返回:

  1. {
  2.  "statusCode" : "000000",
  3.  "result": 
  4.           {
  5.           "uuid":"asd213313",
  6.           "headfileid":"qwe2131",
  7.           "viewfileids":"qweqw3213"
  8.           "headfileidPath":"artist/2016/06/16/image/qweq31q32qe231s31qwe2_20160616142432.jpg",
  9.           "viewfileidsPath":"artist/2016/06/16/image/qweq31q32qe231s31qwe2_20160616142432.jpg"
  10.           }
  11. }
数据参数 必须 说明
id 是 艺人ID
headfileid 否 头像ID
viewfileids 否 大图ID集
正确返回 说明
statusCode 状态码,正常为 000000
result
id 艺人ID
headfileid 头像 的文件ID
viewfileids 展示大图的文件ID集（逗号隔开)
headfileidPath 头像的相对文件路径
viewfileidsPath 大图的相对文件路径
error ""

3, 变更艺人认证信息

功能 : 添加用户名称，艺名等个人资料
路径 ： PUT rest/artist/attestation?id=艺人ID
body :

  1. {
  2.  "idtype":"这是证件类型",
  3.  "idnum":"这是证件号"
  4. }

返回数据：

  1. {
  2.  "statusCode" : "000000",
  3.  "result": 
  4.           {
  5.           "uuid":"asd213313",
  6.           "idtype":"身份证",
  7.           "idnum":"1234567890123"
  8.           }
  9. }
数据参数 必须 说明
id 是 艺人ID
idtype 否 证件类型
idnum 否 证件号
正确返回 说明
statusCode 状态码,正常为 000000
result
id 艺人ID
idtype 证件类型
idnum 证件号
error ""

### 4, 修改艺人资料

功能 : 修改用户个人资料
路径 ： PUT rest/artist?id=艺人ID
body : 

  1. {
  2.  "name":"lichua121n",                    
  3.  "stagename":"123456", 
  4.  "ename":"jack",
  5.  "class1":"演员，导演",                  
  6.  "class2":"电影演员，电视剧导演",        
  7.  "sex":"1",                             
  8.  "birthday":"1990-01-28",               
  9.  "nation":"汉族",                       
  10.  "state":"中国",                        
  11.  "attribute":"身高|123,三围|12/12/12,体重|75kg",(待定)
  12.  "workingtime":"2000-05-01",      (待定)
  13.  "flags":"70后,蜀黎",
  14.  "introduction":"aa",
  15.  "headfileid":"qweqeqwew2131231", 
  16.  "viewfileids":"wqeqwe213,wqeqwe213,qwe21313",
  17.  "email":"10000@qq.com",
  18.  "area":"北京",         
  19.  "address":"三里屯" 
  20. }

正确返回：

  1. {
  2.  "statusCode" : "000000",
  3.  "result": 
  4.     {
  5.      "uuid":"132wq132wq13weqwe23e",
  6.      "name":"lichua121n",                    
  7.      "stagename":"123456", 
  8.      "ename":"jack",
  9.      "class1":"演员，导演",                  
  10.      "class2":"电影演员，电视剧导演",        
  11.      "sex":"1",                             
  12.      "birthday":"1990-01-28",               
  13.      "nation":"汉族",                       
  14.      "state":"中国",                        
  15.      "attribute":"身高|123,三围|12/12/12,体重|75kg", 
  16.      "idtype":"身份证",
  17.      "idnum":"123456789012345678",
  18.      "workingtime":"2000-05-01",      
  19.      "flags":"70后,蜀黎",
  20.      "introduction":"aa",
  21.      "mobile":"12345678901",
  22.      "email":"10000@qq.com",
  23.      "headfileid":"qweqeqwew2131231", 
  24.      "viewfileids":"wqeqwe213,wqeqwe213,qwe21313",
  25.      "headfileidPath":"artist/2016/06/16/image/qweq31q32qe231s31qwe2_20160616142432.jpg", 
  26.      "viewfileidsPath":"artist/2016/06/16/image/qweq31q32qe231s31qwe2_20160616142432.jpg,
  27.                     artist/2016/06/16/image/qweq31q32qe231s31qwe2_20160616142432.jpg,
  28.                     artist/2016/06/16/image/qweq31q32qe231s31qwe2_20160616142432.jpg",        
  29.      "area":"北京",         
  30.      "address":"三里屯",
  31.      "createtime":"2001-01-28",
  32.      "company":"华视",
  33.      "certstatus":"1",
  34.      "serialcode":"13214564",
  35.      "status":"0",
  36.      "audittime":"",
  37.      "auditresult":""
  38.     }
  39.  "error":""
  40. }

jsonMap | 传递参数json用来保存页面添加数据

数据参数 必须 说明
uuid 是 艺人id
name 否 姓名
stagename 否 艺名
ename 否 英文姓名
class1 否 一级分类
class2 否 二级分类
sex 否 性别(1,男.2，女.3，保密)
birthday 否 出生日期(yyyy-MM-dd)
nation 否 民族
state 否 国家
attribute 否 属性信息(属性集,逗号隔开)
workingtime 否 从业时间
flags 否 个性标签(逗号隔开)
introduction 否 简介
mobile 否 手机
email 否 邮箱
headfileid 否 头像(艺人文件库id)
viewfileids 否 展示大图(艺人文件库id,逗号隔开)
area 否 所在区域
address 否 地址
正确返回值 说明
同@1

### 6,修改艺人认证状态（0:未认证 1：认证中 2：已认证 3：认证失败）

功能 ： 通过uuid查询该用户所有信息，没有则返回空字符串
路径 ： PUST | rest/artist/certstatus?id=艺人ID
正确返回：

  1. { "statusCode":"000000",  
  2.     "result":{
  3.              "uuid":"asda21",
  4.              "certstatus":"2"
  5.              },
  6.     "error":""
  7. }
参数 必填 说明
id 是 艺人id
certstatus 是 认证状态
正确返回值 说明
id 艺人ID
certstatus 认证状态

### 6,修改艺人状态（0：正常1：封号）

功能 ： 修改艺人当前状态（正常使用还是封号）
路径 ： PUST | rest/artist/status?id=艺人ID
正确返回：

  1. {  "statusCode":"000000",  
  2.     "result":{
  3.              "uuid":"asda21",
  4.              "status":"0"
  5.              },
  6.     "error":""
  7. }
参数 必填 说明
id 是 艺人id
status 是 艺人状态(正常使用，封号)
正确返回值 说明
id 艺人ID
status 状态

7,根据艺人id获取单条数据

功能 ： 通过uuid查询该用户所有信息，没有则返回空字符串
路径 ： GET | rest/status?id=艺人ID
正确返回：

  1. {  "statusCode":"000000",  
  2.     "result":{
  3.                 "uuid":"123456799013214514",
  4.                 "name":"lichua121n",                    
  5.                 "stagename":"123456", 
  6.                 "ename":"jack",
  7.                 "class1":"演员，导演",                  
  8.                 "class2":"电影演员，电视剧导演",        
  9.                 "sex":"1",                             
  10.                 "birthday":"1990-01-28",               
  11.                 "nation":"汉族",                       
  12.                 "state":"中国",                        
  13.                 "attribute":"身高|123,三围|12/12/12,体重|75kg", 
  14.                 "idtype":"身份证",
  15.                 "idnum":"123456789012345678",
  16.                 "workingtime":"2000-05-01",      
  17.                 "flags":"70后,蜀黎",
  18.                 "introduction":"aa",  
  19.                 "email":"10000@qq.com",  
  20.                 "headfileid":"qweqwe21", 
  21.                 "viewfileids":"qwe2313,qweqeqw3213,qweqwe213",
  22.                 "headfileidPath":"artist/2016/06/16/image/qweq31q32231s31qwe2_20160616142432.jpg",
  23.                 "viewfileidsPath":"artist/2016/06/16/image/qweq31q32qe31qwe2_20160616142432.jpg,
  24.                                artist/2016/06/16/image/qweq31q32qe231s31qwe2_20160616142432.jpg,
  25.                                artist/2016/06/16/image/qweq31q32qe231s31qwe2_20160616142432.jpg", 
  26.                 "area":"北京",         
  27.                 "address":"三里屯"},
  28.     "error":""}
参数 必填 说明
id 是 艺人id
正确返回值 说明
同@1

8,获取所有艺人的数据(不分页带模糊查询)

功能 ： 查询所有用户所有信息，没有则返回空字符串
路径 ： GET | rest/artists?参数
参数 : 

  1.     name=赵丽蓉
  2.     &stagename=小白霜
  3.     &ename=jack
  4.     &class1=演员
  5.     &class2=小品演员
  6.     &sex=1
  7.     &attribute=身高|175cm 体重|75kg (待定)
  8.     &beginbirthday=1990-01-01
  9.     &endbirthday=1983-12-31
  10.     &nation=汉族
  11.     &state=中国
  12.     &workingtime=2016-01-25  (待定)
  13.     &area=北京
  14.     }

正确返回：

  1. {  "statusCode":"000000",  
  2.     "result":{
  3.               "data":{
  4.                       {
  5.                          "uuid":"123456799013214514",
  6.                          "name":"lichua121n",                    
  7.                          "stagename":"123456", 
  8.                          "ename":"jack",
  9.                          "class1":"演员，导演",                  
  10.                          "class2":"电影演员，电视剧导演",        
  11.                          "sex":"1",                             
  12.                          "birthday":"1990-01-28",               
  13.                          "nation":"汉族",                       
  14.                          "state":"中国",                        
  15.                          "attribute":"身高|123,三围|12/12/12,体重|75kg", 
  16.                          "idtype":"身份证",
  17.                          "idnum":"123456789012345678",
  18.                          "workingtime":"2000-05-01",      
  19.                          "flags":"70后,蜀黎",
  20.                          "introduction":"aa",  
  21.                          "email":"10000@qq.com",
  22.                          "headfileid":"qweqwe21", 
  23.                          "viewfileids":"qwe2313,qweqeqw3213,qweqwe213",
  24.                          "headfileidPath":"artist/2016/06/16/image/qweq331we2_20160616142432.jpg",
  25.                          "viewfileidsPath":"artist/2016/06/16/image/qwes31qwe2_20160616142432.jpg,
  26.                                         artist/2016/06/16/image/qwe2s31qwe2_20160616142432.jpg,
  27.                                         artist/2016/06/16/image/qweqs31se2_20160616142432.jpg",
  28.                          "area":"北京",         
  29.                          "address":"三里屯"
  30.                     },{ 同上
  31.                     }
  32.                    }
  33.             },
  34.     "error":""}
@2数据参数 必须 说明
name 否 姓名
stagename 否 艺名
ename 否 英文姓名
class1 否 一级分类
class2 否 二级分类
sex 否 性别(1,男.2，女.3，保密)
attribute 否 属性查询(身高，体重)[待定]
beginbirthday 否 开始出生日期(yyyy-MM-dd)
endbirthday 否 结束出生日期(yyyy-MM-dd)
nation 否 民族
state 否 国家
workingtime 否 从业时间 (待定)
area 否 所在区域
正确返回值 说明
同@1

9,获取所有艺人的数据(分页带模糊查询)

功能 ： 分页查询所有用户所有信息，没有则返回空字符串
路径 ： GET | rest/artists/limit?参数&startIndex=1&pageSize=10
请求参数 :

  1.     name=赵丽蓉
  2.     &stagename=小白霜
  3.     &ename=jack
  4.     &class1=演员
  5.     &class2=小品演员
  6.     &sex=1
  7.     &attribute=身高|175cm 体重|75kg (待定)
  8.     &beginbirthday=1990-01-01
  9.     &endbirthday=1983-12-31
  10.     &nation=汉族
  11.     &state=中国
  12.     &workingtime=2016-01-25  (待定)
  13.     &area=北京
  14. }

正确返回：

  1. {"statusCode":"000000",
  2.  "result":{
  3.            "datas":[
  4.                     {    "uuid":"123456799013214514",
  5.                          "name":"lichua121n",                    
  6.                          "stagename":"123456", 
  7.                          "ename":"jack",
  8.                          "class1":"演员，导演",                  
  9.                          "class2":"电影演员，电视剧导演",        
  10.                          "sex":"1",                             
  11.                          "birthday":"1990-01-28",               
  12.                          "nation":"汉族",                       
  13.                          "state":"中国",                        
  14.                          "attribute":"身高|123,三围|12/12/12,体重|75kg", 
  15.                          "idtype":"身份证",
  16.                          "idnum":"123456789012345678",
  17.                          "workingtime":"2000-05-01",      
  18.                          "flags":"70后,蜀黎",
  19.                          "introduction":"aa",  
  20.                          "email":"10000@qq.com",
  21.                          "headfileid":"qweqwe21", 
  22.                          "viewfileids":"qwe2313,qweqeqw3213,qweqwe213",
  23.                          "headfileidPath":"artist/2016/06/16/image/qweq3we2_20160616142432.jpg",
  24.                          "viewfileidsPath":"artist/2016/06/16/image/qw31qwe2_20160616142432.jpg,
  25.                                         artist/2016/06/16/image/qws31qwe2_20160616142432.jpg,
  26.                                         artist/2016/06/16/image/qs31se2_20160616142432.jpg",
  27.                          "area":"北京",         
  28.                          "address":"三里屯"
  29.                   },{同上
  30.                   }],
  31.              "startIndex":0,
  32.              "pageSize":10,
  33.              "total":9},
  34.  "error":""
  35. }
参数 必填 说明
同@2
正确返回值 说明
同@1
添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注