organ.go 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831
  1. package docs
  2. /**
  3. * @api {PUT} /api/v1/mop/applets-ecol-account/organ/register [C/S]企业方账号注册
  4. * @apiGroup Applets Ecol Account
  5. * @apiVersion __API_VERSION__
  6. * @apiParam (RequestBody) {string} phone 手机号
  7. * @apiParam (RequestBody) {string} password 登录密码,需要通过md5加密
  8. * @apiParam (RequestBody) {string} verifyCode 验证码
  9. * @apiParam (RequestBody) {bool} isApp true:代表移动端
  10. * @apiParamExample {json} Request-Example:
  11. * {
  12. * "phone": "18589095302",
  13. * "password": "5cff6f7c4357ee0001c96fab",
  14. * "verifyCode":"123456",
  15. * "isApp":true
  16. * }
  17. * @apiSuccessExample {json} Success Status:
  18. * HTTP/1.1 200 OK
  19. * {
  20. * "errcode": "OK",
  21. * "error": "",
  22. * "data": {
  23. * "account": "abc123456",
  24. * "jwtToken":"357ee0001c9......",
  25. * "refreshToken":"357ee0001c9...",
  26. * "jwtTokenExpireTime": 7200,
  27. * "env":"mop-uat", //值为:mop-uat(uat环境),"mop-fdep"(证通云),"mop-private"(私有化环境)
  28. * "accountTraceId":"账号id",
  29. * "organTraceId":"企业id",
  30. * "appGrayCount":1 //灰度数量
  31. * }
  32. * }
  33. * @apiErrorExample Error Status:
  34. * HTTP/1.1 !=200 服务端异常
  35. */
  36. /**
  37. * @api {PUT} /api/v1/mop/applets-ecol-account/organ/apply [C/S]企业方企业信息提交申请
  38. * @apiGroup Applets Ecol Account
  39. * @apiVersion __API_VERSION__
  40. * @apiParam (RequestBody) {int} applyType 申请类型,1:企业账号进行企业认证;2:个人账号升级到企业账号
  41. * @apiParam (RequestBody) {string} accountTraceId 账户绑定id
  42. * @apiParam (RequestBody) {string} organTraceId 企业绑定id,首次认证可以为空,重新认证不能为空
  43. * @apiParam (RequestBody) {json} organInfo 企业信息
  44. * @apiParam (RequestBody) {json} adminInfo 管理员信息
  45. * @apiParam (RequestBody) {string} verifyCode 手机验证码
  46. * @apiParamExample {json} Request-Example:
  47. * {
  48. * "applyType":1,
  49. * "accountTraceId":"5cff6f7c4357ee0001c96fab",
  50. * "organTraceId":"5cff6f7c4357ee0001c96fac",
  51. * "organInfo": {
  52. * "name":"企业名称",
  53. * "socialCreditCode":"统一社会信用代码",
  54. * "licenseNetdiskId":"企业营业执照网盘id",
  55. * "authorizationNetdiskId":"授权书网盘id"
  56. * },
  57. * "adminInfo": {
  58. * "name":"管理员姓名",
  59. * "identity":"管理员身份证", //需要通过des加密
  60. * "phone":"管理员手机号" //需要通过des加密
  61. * }
  62. * "verifyCode":"123456"
  63. * }
  64. * @apiSuccessExample {json} Success Status:
  65. * HTTP/1.1 200 OK
  66. * {
  67. * "errcode": "OK",
  68. * "error": "",
  69. * "data": {
  70. * "organTraceId":"5cff6f7c4357ee0001c96fac"
  71. * "role":"organ_admin"
  72. * }
  73. * }
  74. * @apiErrorExample Error Status:
  75. * HTTP/1.1 !=200 服务端异常
  76. */
  77. /**
  78. * @api {PUT} /api/v1/mop/applets-ecol-account/organ/person/apply [C/S]企业方个人信息提交申请
  79. * @apiGroup Applets Ecol Account
  80. * @apiVersion __API_VERSION__
  81. * @apiParam (RequestBody) {string} accountTraceId 账户绑定id
  82. * @apiParam (RequestBody) {string} name 姓名
  83. * @apiParam (RequestBody) {string} identity 身份证,需要通过des加密
  84. * @apiParam (RequestBody) {string} phone 手机号,需要通过des加密
  85. * @apiParam (RequestBody) {string} verifyCode 手机验证码
  86. * @apiParamExample {json} Request-Example:
  87. * {
  88. * "accountTraceId":"5cff6f7c4357ee0001c96fab",
  89. * "name":"姓名",
  90. * "identity":"身份证",
  91. * "phone":"手机号"
  92. * "verifyCode":"123456"
  93. * }
  94. * @apiSuccessExample {json} Success Status:
  95. * HTTP/1.1 200 OK
  96. * {
  97. * "errcode": "OK",
  98. * "error": "",
  99. * "data": {
  100. * "organTraceId":"5cff6f7c4357ee0001c96fac",
  101. * "role":"organ_admin" //organ_admin:管理员,organ_platform_member:项目成员,person:个人,service_provider:服务商
  102. * }
  103. * }
  104. * @apiErrorExample Error Status:
  105. * HTTP/1.1 !=200 服务端异常
  106. */
  107. /**
  108. * @api {GET} /api/v1/mop/applets-ecol-account/organ/info [C/S]企业方获取账号管理信息
  109. * @apiGroup Applets Ecol Account
  110. * @apiVersion __API_VERSION__
  111. * @apiSuccessExample {json} Success Status:
  112. * HTTP/1.1 200 OK
  113. * {
  114. * "errcode": "OK",
  115. * "error": "",
  116. * "data": {
  117. * "accountTraceId":"5cff6f7c4357ee0001c96fab",
  118. * "organTraceId":"5cff6f7c4357ee0001c96fac",
  119. * "accountInfo":{ //账号信息
  120. * "account": "abc123456",
  121. * "phone":12345678912,
  122. * "createTime":1573702771000,
  123. * },
  124. * "organInfo": { //企业企业信息
  125. * "name":"企业名称",
  126. * "socialCreditCode":"统一社会信用代码",
  127. * "licenseNetdiskId":"企业营业执照网盘id",
  128. * "authorizationNetdiskId":"授权书网盘id",
  129. * "reviewStatus":3 //1:审核中,2:未认证(被驳回),3:已审核,4:已过期,5:已冻结
  130. * },
  131. * "adminInfo": { //管理员信息
  132. * "name":"管理员姓名",
  133. * "identity":"管理员身份证",
  134. * "phone":"管理员手机号"
  135. * }
  136. * }
  137. * }
  138. * @apiErrorExample Error Status:
  139. * HTTP/1.1 !=200 服务端异常
  140. */
  141. /**
  142. * @api {POST} /api/v1/mop/applets-ecol-account/organ/login [C/S]企业方账号登录
  143. * @apiGroup Applets Ecol Account
  144. * @apiVersion __API_VERSION__
  145. * @apiParam (RequestBody) {string} account 账号
  146. * @apiParam (RequestBody) {string} password 登录密码
  147. * @apiParam (RequestBody) {bool} isWeb 页面登录
  148. * @apiParamExample {json} Request-Example:
  149. * {
  150. * "account": "abc123456",
  151. * "password": "5cff6f7c4357ee0001c96fab",
  152. * "isWeb":true
  153. * }
  154. * @apiSuccessExample {json} Success Status:
  155. * HTTP/1.1 200 OK
  156. * {
  157. * "errcode": "OK",
  158. * "error": "",
  159. * "data": {
  160. * "accountTraceId":"5cff6f7c4357ee0001c96fab",
  161. * "organTraceId":"5cff6f7c4357ee0001c96fac",
  162. * "jwtToken":"5cff6f7c4357ee0001c96fab......",
  163. * "refreshToken":"5cff6f7c4357ee0001c96fac......",
  164. * "jwtTokenExpireTime":7200, //jwtToken有效时长,单位是秒
  165. * "role":"organ_admin", //organ_admin:管理员,organ_platform_member:项目成员,person:个人,service_provider:服务商
  166. * "needOrganApply":true, //true代表需要提交资料,false代表不需要,
  167. * "account":"dev",
  168. * "name":"张三",
  169. * "organName":"哈哈牛逼科技",
  170. * "env":"mop-uat", //值为:mop-uat(uat环境),"mop-fdep"(证通云),"mop-private"(私有化环境)
  171. * "appGrayCount":10,
  172. * "organExpireTime":1574143635572 //企业过期时间
  173. * }
  174. * }
  175. * @apiErrorExample Error Status:
  176. * HTTP/1.1 !=200 服务端异常
  177. */
  178. /**
  179. * @api {POST} /api/v1/mop/applets-ecol-account/organ/account/phone/modify [C/S]企业方管理员或成员修改手机号
  180. * @apiGroup Applets Ecol Account
  181. * @apiVersion __API_VERSION__
  182. * @apiParam (RequestBody) {string} originalPhone 原始手机号,需要通过des加密
  183. * @apiParam (RequestBody) {string} verifyCode 验证码
  184. * @apiParam (RequestBody) {string} newPhone 新手机号,需要通过des加密
  185. * @apiParamExample {json} Request-Example:
  186. * {
  187. * "originalPhone": "12345678912",
  188. * "verifyCode": "123456",
  189. * "newPhone": "18868838866"
  190. * }
  191. * @apiSuccessExample {json} Success Status:
  192. * HTTP/1.1 200 OK
  193. * {
  194. * "errcode": "OK",
  195. * "error": "",
  196. * "data": {
  197. * "phone":"18868838866"
  198. * }
  199. * }
  200. * @apiErrorExample Error Status:
  201. * HTTP/1.1 !=200 服务端异常
  202. */
  203. /**
  204. * @api {POST} /api/v1/mop/applets-ecol-account/organ/account/password/modify [C/S]企业方管理员或者成员修改登录密码
  205. * @apiGroup Applets Ecol Account
  206. * @apiVersion __API_VERSION__
  207. * @apiParam (RequestBody) {string} originalPassword 原始密码
  208. * @apiParam (RequestBody) {string} newPassword 新密码
  209. * @apiParamExample {json} Request-Example:
  210. * {
  211. * "originalPassword": "12345678912",
  212. * "newPassword": "18868838866"
  213. * }
  214. * @apiSuccessExample {json} Success Status:
  215. * HTTP/1.1 200 OK
  216. * {
  217. * "errcode": "OK",
  218. * "error": "",
  219. * data": {
  220. * "newJwtToken":"5cff6f7c4357ee0001c96fab......",
  221. * "refreshToken":"5cff6f7c4357ee0001c96fab......"
  222. * }
  223. * }
  224. * @apiErrorExample Error Status:
  225. * HTTP/1.1 !=200 服务端异常
  226. */
  227. /**
  228. * @api {POST} /api/v1/mop/applets-ecol-account/organ/account/password/forget [C/S]企业方管理员或者成员忘记登录密码
  229. * @apiGroup Applets Ecol Account
  230. * @apiVersion __API_VERSION__
  231. * @apiParam (RequestBody) {string} phone 手机,需要通过des加密
  232. * @apiParam (RequestBody) {string} verifyCode 验证码
  233. * @apiParam (RequestBody) {string} newPassword 新密码
  234. * @apiParamExample {json} Request-Example:
  235. * {
  236. * "phone":"18868838866",
  237. * "verifyCode": "123456",
  238. * "newPassword": "aA123456"
  239. * }
  240. * @apiSuccessExample {json} Success Status:
  241. * HTTP/1.1 200 OK
  242. * {
  243. * "errcode": "OK",
  244. * "error": "",
  245. * "data": null
  246. * }
  247. * @apiErrorExample Error Status:
  248. * HTTP/1.1 !=200 服务端异常
  249. */
  250. /**
  251. * @api {POST} /api/v1/mop/applets-ecol-account/organ/business/admin-info/modify [C/S]企业方修改管理员信息
  252. * @apiGroup Applets Ecol Account
  253. * @apiVersion __API_VERSION__
  254. * @apiParam (RequestBody) {string} organTraceId 企业绑定id
  255. * @apiParam (RequestBody) {string} name 管理员姓名
  256. * @apiParam (RequestBody) {string} identity 管理员身份证,需要通过des加密
  257. * @apiParam (RequestBody) {string} phone 管理员手机号,需要通过des加密
  258. * @apiParamExample {json} Request-Example:
  259. * {
  260. * "organTraceId":"5cff6f7c4357ee0001c96fab",
  261. * "name": "张五",
  262. * "identity": "12345678912345678",
  263. * "phone": "18868838866"
  264. * }
  265. * @apiSuccessExample {json} Success Status:
  266. * HTTP/1.1 200 OK
  267. * {
  268. * "errcode": "OK",
  269. * "error": "",
  270. * "data": null
  271. * }
  272. * @apiErrorExample Error Status:
  273. * HTTP/1.1 !=200 服务端异常
  274. */
  275. /**
  276. * @api {POST} /api/v1/mop/applets-ecol-account/organ/phone/verify-code [C/S]企业方账号注册获取手机验证码
  277. * @apiGroup Applets Ecol Account
  278. * @apiVersion __API_VERSION__
  279. * @apiParam (RequestBody) {string} type 获取验证码用途类型,register:注册时的验证码,modify:修改时的验证码,forget:忘记密码,submit_modify:提交修改时的验证码
  280. * @apiParam (RequestBody) {string} accountTraceId 账号绑定id,根据情况选填
  281. * @apiParam (RequestBody) {string} phone 手机号,需要通过des加密
  282. * @apiParamExample {json} Request-Example:
  283. * {
  284. * "type":"register", //register:注册时的验证码,modify:修改时的验证码,forget:忘记密码
  285. * "accountTraceId":"5cff6f7c4357ee0001c96fab", //type=modify的时候,需要带上
  286. * "phone": "12345678912"
  287. * }
  288. * @apiSuccessExample {json} Success Status:
  289. * HTTP/1.1 200 OK
  290. * {
  291. * "errcode": "OK",
  292. * "error": "",
  293. * "data": null
  294. * }
  295. * @apiErrorExample Error Status:
  296. * HTTP/1.1 !=200 服务端异常
  297. */
  298. /**
  299. * @api {POST} /api/v1/mop/applets-ecol-account/phone/verify-code/check [C/S]企业方确认验证码
  300. * @apiGroup Applets Ecol Account
  301. * @apiVersion __API_VERSION__
  302. * @apiParam (RequestBody) {string} type 获取验证码用途类型
  303. * @apiParam (RequestBody) {string} accountTraceId 账号绑定id,根据type来判断是否填写
  304. * @apiParam (RequestBody) {string} phone 手机号,需要通过des加密
  305. * @apiParam (RequestBody) {string} verifyCode 验证码
  306. * @apiParamExample {json} Request-Example:
  307. * {
  308. * "type":"register", //register:注册时的验证码,modify:修改时的验证码
  309. * "accountTraceId":"5e0d8fcf27b33b0001c81f66", //type=modify的时候不能为空
  310. * "phone": "12345678912",
  311. * "verifyCode":"123456"
  312. * }
  313. * @apiSuccessExample {json} Success Status:
  314. * HTTP/1.1 200 OK
  315. * {
  316. * "errcode": "OK",
  317. * "error": "",
  318. * "data": null
  319. * }
  320. * @apiErrorExample Error Status:
  321. * HTTP/1.1 !=200 服务端异常
  322. */
  323. /**
  324. * @api {PUT} /api/v1/mop/applets-ecol-account/organ/platform/account/add [C/S]企业方添加成员
  325. * @apiGroup Applets Ecol Account
  326. * @apiVersion __API_VERSION__
  327. * @apiParam (RequestBody) {string} account 账号
  328. * @apiParam (RequestBody) {string} password 密码
  329. * @apiParam (RequestBody) {string} phone 手机号,需要通过des加密
  330. * @apiParamExample {json} Request-Example:
  331. * {
  332. * "account":"zhangsan",
  333. * "password":"123456",
  334. * "phone": "12345678912"
  335. * }
  336. * @apiSuccessExample {json} Success Status:
  337. * HTTP/1.1 200 OK
  338. * {
  339. * "errcode": "OK",
  340. * "error": "",
  341. * "data": {
  342. * "accountTraceId":"5dd38693c3666e0b83a6c519"
  343. * }
  344. * }
  345. * @apiErrorExample Error Status:
  346. * HTTP/1.1 !=200 服务端异常
  347. */
  348. /**
  349. * @api {POST} /api/v1/mop/applets-ecol-account/organ/platform/account/modify [C/S]企业方编辑成员
  350. * @apiGroup Applets Ecol Account
  351. * @apiVersion __API_VERSION__
  352. * @apiParam (RequestBody) {string} accountTraceId 账号绑定id
  353. * @apiParam (RequestBody) {string} account 账号
  354. * @apiParam (RequestBody) {string} phone 手机号,需要通过des加密
  355. * @apiParamExample {json} Request-Example:
  356. * {
  357. * "accountTraceId":"5dd38693c3666e0b83a6c519",
  358. * "account":"zhangsan",
  359. * "phone": "12345678912"
  360. * }
  361. * @apiSuccessExample {json} Success Status:
  362. * HTTP/1.1 200 OK
  363. * {
  364. * "errcode": "OK",
  365. * "error": "",
  366. * "data": {
  367. * "accountTraceId":"5dd38693c3666e0b83a6c519"
  368. * }
  369. * }
  370. * @apiErrorExample Error Status:
  371. * HTTP/1.1 !=200 服务端异常
  372. */
  373. /**
  374. * @api {POST} /api/v1/mop/applets-ecol-account/organ/platform/account/delete [C/S]企业方删除成员
  375. * @apiGroup Applets Ecol Account
  376. * @apiVersion __API_VERSION__
  377. * @apiParam (RequestParam) {[]string} accountTraceIds 成员条目id
  378. * @apiParamExample {json} Request-Example:
  379. * {
  380. * "accountTraceIds":["5dd38693c3666e0b83a6c519","5dd38693c3666e0b83a6c51a"]
  381. * }
  382. * @apiSuccessExample {json} Success Status:
  383. * HTTP/1.1 200 OK
  384. * {
  385. * "errcode": "OK",
  386. * "error": "",
  387. * "data": null
  388. * }
  389. * @apiErrorExample Error Status:
  390. * HTTP/1.1 !=200 服务端异常
  391. */
  392. /**
  393. * @api {POST} /api/v1/mop/applets-ecol-account/organ/platform/account/password/reset [C/S]企业方重置成员密码
  394. * @apiGroup Applets Ecol Account
  395. * @apiVersion __API_VERSION__
  396. * @apiParam (RequestBody) {string} accountTraceId 账号绑定id
  397. * @apiParamExample {json} Request-Example:
  398. * {
  399. * "accountTraceId":"5dd38693c3666e0b83a6c519"
  400. * }
  401. * @apiSuccessExample {json} Success Status:
  402. * HTTP/1.1 200 OK
  403. * {
  404. * "errcode": "OK",
  405. * "error": "",
  406. * "data": {
  407. * "accountTraceId":"5dd38693c3666e0b83a6c519"
  408. * }
  409. * }
  410. * @apiErrorExample Error Status:
  411. * HTTP/1.1 !=200 服务端异常
  412. */
  413. /**
  414. * @api {GET} /api/v1/mop/applets-ecol-account/organ/platform/account/list?page=1&size=20 [C/S]企业方获取成员列表
  415. * @apiGroup Applets Ecol Account
  416. * @apiVersion __API_VERSION__
  417. * @apiParam (RequestParam) {string} page 页码,默认是1
  418. * @apiParam (RequestParam) {string} size 页大小,默认是20
  419. * @apiSuccessExample {json} Success Status:
  420. * HTTP/1.1 200 OK
  421. * {
  422. * "errcode": "OK",
  423. * "error": "",
  424. * "data": {
  425. * "total":100,
  426. * "page":1,
  427. * "size":20,
  428. * "items":[
  429. * {
  430. * "accountTraceId":"5dd38693c3666e0b83a6c519",
  431. * "account":"zhangsan",
  432. * "phone":"12345678912",
  433. * "createTime":1574143635572
  434. * },
  435. * {
  436. * "accountTraceId":"5dd38693c3666e0b83a6c51a",
  437. * "account":"lisi",
  438. * "phone":"12345678912",
  439. * "createTime":1574143635572
  440. * },
  441. * {...}
  442. * ]
  443. * }
  444. * }
  445. * @apiErrorExample Error Status:
  446. * HTTP/1.1 !=200 服务端异常
  447. */
  448. /**
  449. * @api {GET} /api/v1/mop/applets-ecol-account/organ/platform/account/search?filter=张三&page=1&size=20 [C/S]企业方查询成员
  450. * @apiGroup Applets Ecol Account
  451. * @apiVersion __API_VERSION__
  452. * @apiParam (RequestParam) {string} filter 搜索条件,用户名或者手机号
  453. * @apiParam (RequestParam) {string} page 页码,默认是1
  454. * @apiParam (RequestParam) {string} size 页大小,默认是20
  455. * @apiSuccessExample {json} Success Status:
  456. * HTTP/1.1 200 OK
  457. * {
  458. * "errcode": "OK",
  459. * "error": "",
  460. * "data": {
  461. * "total":100,
  462. * "page":1,
  463. * "size":20,
  464. * "items":[
  465. * {
  466. * "accountTraceId":"5dd38693c3666e0b83a6c519",
  467. * "account":"zhangsan",
  468. * "phone":"12345678912",
  469. * "createTime":1574143635572
  470. * },
  471. * {
  472. * "accountTraceId":"5dd38693c3666e0b83a6c51a",
  473. * "account":"lisi",
  474. * "phone":"12345678912",
  475. * "createTime":1574143635572
  476. * },
  477. * {...}
  478. * ]
  479. * }
  480. * }
  481. * @apiErrorExample Error Status:
  482. * HTTP/1.1 !=200 服务端异常
  483. */
  484. /**
  485. * @api {GET} /api/v1/mop/applets-ecol-account/organ/platform/account/organ-info/:accountTraceId [S/S]企业方通过开发者id获取企业信息
  486. * @apiGroup Applets Ecol Account
  487. * @apiVersion __API_VERSION__
  488. * @apiParam (RequestParam) {string} accountTraceId 开发者账号id
  489. * @apiSuccessExample {json} Success Status:
  490. * HTTP/1.1 200 OK
  491. * {
  492. * "errcode": "OK",
  493. * "error": "",
  494. * "data": {
  495. * "groupId":"jaojgoajgiajojiaogj",
  496. * "groupName":"凡泰极客", //企业名称
  497. * "reviewStatus":1 //1:审核中,2:未认证,被驳回,3:已认证,4:已过期,5:已冻结
  498. * }
  499. * }
  500. * @apiErrorExample Error Status:
  501. * HTTP/1.1 !=200 服务端异常
  502. */
  503. /**
  504. * @api {GET} /api/v1/mop/applets-ecol-account/organ/platform/account/power/:accountTraceId [S/S]企业方小程序判断权限
  505. * @apiGroup Applets Ecol Account
  506. * @apiVersion __API_VERSION__
  507. * @apiParam (RequestParam) {string} accountTraceId 开发者账号id
  508. * @apiSuccessExample {json} Success Status:
  509. * HTTP/1.1 200 OK
  510. * {
  511. * "errcode": "FC_ORGAN_POWER_CHECK_REVIEWING_ERROR", //OK代表可以true,其他情况代表false
  512. * "error": "当前企业状态为审核中状态,无法使用该功能", //前端需要展示错误信息
  513. * "data": {
  514. * "isOK":false
  515. * }
  516. * }
  517. * @apiErrorExample Error Status:
  518. * HTTP/1.1 !=200 服务端异常
  519. */
  520. /**
  521. * @api {POST} /api/v1/mop/applets-ecol-account/organ/email/verify-code [C/S]企业方账号获取邮箱验证码
  522. * @apiGroup Applets Ecol Account
  523. * @apiVersion __API_VERSION__
  524. * @apiParam (RequestBody) {string} email 邮箱,需要通过des加密
  525. * @apiParamExample {json} Request-Example:
  526. * {
  527. * "email":"dev@finogeeks.com"
  528. * }
  529. * @apiSuccessExample {json} Success Status:
  530. * HTTP/1.1 200 OK
  531. * {
  532. * "errcode": "OK",
  533. * "error": "",
  534. * "data": {
  535. * "msg":"发送成功"
  536. * }
  537. * }
  538. * @apiErrorExample Error Status:
  539. * HTTP/1.1 !=200 服务端异常
  540. */
  541. /**
  542. * @api {POST} /api/v1/mop/applets-ecol-account/organ/email/active [C/S]企业方账号注册激活邮箱验证码
  543. * @apiGroup Applets Ecol Account
  544. * @apiVersion __API_VERSION__
  545. * @apiParam (RequestBody) {string} email 邮箱,需要通过des加密
  546. * @apiParam (RequestBody) {string} verifyCode 验证码
  547. * @apiParamExample {json} Request-Example:
  548. * {
  549. * "email":"dev@finogeeks.com",
  550. * "verifyCode":"200200"
  551. * }
  552. * @apiSuccessExample {json} Success Status:
  553. * HTTP/1.1 200 OK
  554. * {
  555. * "errcode": "OK",
  556. * "error": "",
  557. * "data": {
  558. * "accountTraceId":"5cff6f7c4357ee0001c96fab",
  559. * "organTraceId":"5cff6f7c4357ee0001c96fac",
  560. * "env":"mop-uat", //值为:mop-uat(uat环境),"mop-fdep"(证通云),"mop-private"(私有化环境)
  561. * }
  562. * }
  563. * @apiErrorExample Error Status:
  564. * HTTP/1.1 !=200 服务端异常
  565. */
  566. /**
  567. * @api {GET} /api/v1/mop/applets-ecol-account/organ/account/info [C/S]企业方获取账号信息
  568. * @apiGroup Applets Ecol Account
  569. * @apiVersion __API_VERSION__
  570. * @apiSuccessExample {json} Success Status:
  571. * HTTP/1.1 200 OK
  572. * {
  573. * "errcode": "OK",
  574. * "error": "",
  575. * "data": {
  576. * "account":"zhangsan",
  577. * "name":"张三",
  578. * "identity":"33333333333333333",
  579. * "phone":"12345678912",
  580. * "organId":"5cff6f7c4357ee0001c96fab"
  581. * }
  582. * }
  583. * @apiErrorExample Error Status:
  584. * HTTP/1.1 !=200 服务端异常
  585. */
  586. /**
  587. * @api {POST} /api/v1/mop/applets-ecol-account/organ/account/modify [C/S]企业方修改账号信息
  588. * @apiGroup Applets Ecol Account
  589. * @apiVersion __API_VERSION__
  590. * @apiParamExample {json} Request-Example:
  591. * {
  592. * "account":"zhangsan", //如果不修改,传原值或者空
  593. * "name":"张三", //如果不修改,传原值或者空
  594. * "phone":"12345678912", //如果不修改,传原值或者空
  595. * "identity":"身份证", //如果不修改,传原值或者空
  596. * "verifyCode":"850822",
  597. * "newVerifyCode":"123456" //修改手机号的时候,需要传
  598. * }
  599. * @apiSuccessExample {json} Success Status:
  600. * HTTP/1.1 200 OK
  601. * {
  602. * "errcode": "OK",
  603. * "error": "",
  604. * "data": {
  605. * "account":"zhangsan",
  606. * "phone":"12345678912",
  607. * "jwtToken":"243356546dsfd...", //不修改账号的话,jwtToken="",前端无需替换,否则需要替换
  608. * "refreshToken":"243356546dsfd..."
  609. * }
  610. * }
  611. * @apiErrorExample Error Status:
  612. * HTTP/1.1 !=200 服务端异常
  613. */
  614. /**
  615. * @api {GET} /api/v1/mop/applets-ecol-account/organ/account/admin-info?organTraceId=5dd38693c3666e0b83a6c51a [C/S]企业方获取管理员信息
  616. * @apiGroup Applets Ecol Account
  617. * @apiVersion __API_VERSION__
  618. * @apiSuccessExample {json} Success Status:
  619. * HTTP/1.1 200 OK
  620. * {
  621. * "errcode": "OK",
  622. * "error": "",
  623. * "data": {
  624. * "name":"张三",
  625. * "identity":"33333333333333333",
  626. * "phone":"12345678912",
  627. * }
  628. * }
  629. * @apiErrorExample Error Status:
  630. * HTTP/1.1 !=200 服务端异常
  631. */
  632. /**
  633. * @api {GET} /api/v1/mop/applets-ecol-account/organ/business/info/:organTraceId [S/S]企业方通过机构id获取企业信息
  634. * @apiGroup Applets Ecol Account
  635. * @apiVersion __API_VERSION__
  636. * @apiParam (RequestParam) {string} organTraceId 机构id
  637. * @apiSuccessExample {json} Success Status:
  638. * HTTP/1.1 200 OK
  639. * {
  640. * "errcode": "OK",
  641. * "error": "",
  642. * "data": {
  643. * "groupId":"jaojgoajgiajojiaogj",
  644. * "groupName":"凡泰极客", //企业名称
  645. * "reviewStatus":1 //1:审核中,2:未认证,被驳回,3:已认证,4:已过期,5:已冻结
  646. * }
  647. * }
  648. * @apiErrorExample Error Status:
  649. * HTTP/1.1 !=200 服务端异常
  650. */
  651. /**
  652. * @api {GET} /api/v1/mop/applets-ecol-account/organ/finstore/limit-info [C/S]企业方获取限制数量信息
  653. * @apiGroup Applets Ecol Account
  654. * @apiVersion __API_VERSION__
  655. * @apiParam (RequestParam) {string="appId","binding","member"} type 获取类型:appId-小程序、binding-应用、member-成员
  656. * @apiSuccessExample {json} Success Status:
  657. * HTTP/1.1 200 OK
  658. * {
  659. * "errcode": "OK",
  660. * "error": "",
  661. * "data": {
  662. * "limitNum":10, //上限
  663. * "hasUseNum":3 //已经使用数量
  664. * }
  665. * }
  666. * @apiErrorExample Error Status:
  667. * HTTP/1.1 !=200 服务端异常
  668. */
  669. /**
  670. * @api {POST} /api/v1/mop/applets-ecol-account/organ/platform/add/count/check [C/S]企业方添加成员数量校验
  671. * @apiGroup Applets Ecol Account
  672. * @apiVersion __API_VERSION__
  673. * @apiSuccessExample {json} Success Status:
  674. * HTTP/1.1 200 OK
  675. * {
  676. * "errcode": "FC_ORGAN_PERSON_ADD_MEMBER_MAX", //FC_ORGAN_BUSINESS_ADD_MEMBER_MAX
  677. * "error": "成员数量已达上限,如需新增成员,请联系平台运营方",
  678. * "data": null
  679. * }
  680. * @apiErrorExample Error Status:
  681. * HTTP/1.1 !=200 服务端异常
  682. */
  683. /**
  684. * @api {POST} /api/v1/mop/applets-ecol-account/organ/finstore/add/count/check [C/S]企业方添加小程序、合作应用数量校验
  685. * @apiGroup Applets Ecol Account
  686. * @apiVersion __API_VERSION__
  687. * @apiParamExample {json} Request-Example:
  688. * {
  689. * "type":"app" //cooApp合作应用,app小程序
  690. * }
  691. * @apiSuccessExample {json} Success Status:
  692. * HTTP/1.1 200 OK
  693. * {
  694. * "errcode": "FC_ORGAN_FINSTORE_ADD_APP_MAX", //FC_ORGAN_FINSTORE_PERSON_ADD_APP_MAX:个人创建小程序失败情况,FC_ORGAN_FINSTORE_ADD_APP_MAX:企业创建小程序失败情况,FC_ORGAN_FINSTORE_PERSON_ADD_COO_APP_MAX:个人创建应用失败情况,FC_ORGAN_FINSTORE_ADD_COO_APP_MAX:企业创建应用失败情况
  695. * "error": "小程序数量已达上限,如需新增小程序数量,请联系平台运营方",
  696. * "data": null
  697. * }
  698. * @apiErrorExample Error Status:
  699. * HTTP/1.1 !=200 服务端异常
  700. */
  701. /**
  702. * @api {GET} /api/v1/mop/applets-ecol-account/organ/role/list [C/S][企业端]查询角色列表
  703. * @apiGroup Applets Ecol Account
  704. * @apiVersion __API_VERSION__
  705. * @apiParamExample {json} Request-Example:
  706. * {
  707. data : [
  708. {
  709. "id":"1231233123"
  710. "name":"管理员"
  711. "peopleNumber" 3
  712. }
  713. ]
  714. }
  715. * @apiErrorExample Error Status:
  716. * HTTP/1.1 !=200 服务端异常
  717. */
  718. /**
  719. * @api {POST} /api/v1/mop/applets-ecol-account/organ/role/add [C/S][企业端]新增角色
  720. * @apiGroup Applets Ecol Account
  721. * @apiVersion __API_VERSION__
  722. * @apiParam {string} name
  723. * @apiParam {[]string} authList 权限列表
  724. * @apiSuccessExample {json} Success Status:
  725. * HTTP/1.1 200 OK
  726. * {
  727. * "data": {},
  728. * "errcode": "OK",
  729. * "error": ""
  730. *}
  731. * @apiErrorExample Error Status:
  732. * HTTP/1.1 !=200 服务端异常
  733. */
  734. /**
  735. * @api {PUT} /api/v1/mop/applets-ecol-account/organ/role/edit [C/S][企业端]配置角色权限
  736. * @apiGroup Applets Ecol Account
  737. * @apiVersion __API_VERSION__
  738. * @apiParam {string} id
  739. * @apiParam {[]string} authList 权限列表
  740. * @apiSuccessExample {json} Success Status:
  741. * HTTP/1.1 200 OK
  742. * {
  743. * "data": {},
  744. * "errcode": "OK",
  745. * "error": ""
  746. *}
  747. * @apiErrorExample Error Status:
  748. * HTTP/1.1 !=200 服务端异常
  749. */
  750. /**
  751. * @api {DELETE} /api/v1/mop/applets-ecol-account/organ/role/delete [C/S][企业端]删除角色
  752. * @apiGroup Applets Ecol Account
  753. * @apiVersion __API_VERSION__
  754. * @apiParam {string} id
  755. * @apiSuccessExample {json} Success Status:
  756. * HTTP/1.1 200 OK
  757. * {
  758. * "data": {},
  759. * "errcode": "OK",
  760. * "error": ""
  761. *}
  762. * @apiErrorExample Error Status:
  763. * HTTP/1.1 !=200 服务端异常
  764. */
  765. /**
  766. * @api {GET} /api/v1/mop/applets-ecol-account/organ/auth/list [C/S][企业端]查询权限列表
  767. * @apiGroup Applets Ecol Account
  768. * @apiVersion __API_VERSION__
  769. * @apiParam {string} roleId
  770. * @apiParamExample {json} Request-Example:
  771. * {
  772. data : [
  773. {
  774. "id":"1231233123"
  775. "name":"SDK管理"
  776. "nameEn":"SSCCSDK"
  777. "status" : 1
  778. "childrens" : [
  779. {
  780. "id":"555555"
  781. "name":"新增SDK"
  782. "nameEn":"addSDK"
  783. "status" : 1
  784. },
  785. {
  786. "id":"66666"
  787. "name":"SDK管理"
  788. "nameEn":"ManageSDK"
  789. "status" : 1
  790. }
  791. ]
  792. }
  793. ]
  794. }
  795. * @apiErrorExample Error Status:
  796. * HTTP/1.1 !=200 服务端异常
  797. */