{ "swagger": "2.0", "info": { "description": "媒体后台接口", "title": "广告联盟-媒体平台", "termsOfService": "http://swagger.io/terms/", "contact": { "name": "dengbiao", "url": "http://www.swagger.io/support", "email": "1239118001@qq.com" }, "license": { "name": "Apache 2.0", "url": "http://www.apache.org/licenses/LICENSE-2.0.html" }, "version": "1.0" }, "host": "localhost:1004 or xxxxx.medium.dengbiao.top", "paths": { "/api/applet/application/ad/space/save": { "post": { "description": "小程序应用-广告位新增", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "小程序应用------嘉俊" ], "summary": "广告位新增", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true }, { "description": "请求参数", "name": "args", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.AppletApplicationAdSpaceSaveReq" } } ], "responses": { "200": { "description": "具体看返回内容", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/application/applet/list": { "post": { "description": "小程序应用-列表数据", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "小程序应用------嘉俊" ], "summary": "列表数据", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true }, { "description": "请求参数", "name": "args", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.AppletApplicationListReq" } } ], "responses": { "200": { "description": "具体看返回内容---这是data里面的数据", "schema": { "$ref": "#/definitions/md.AppletApplicationListRes" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/application/applet/save": { "post": { "description": "小程序应用-新增或保存", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "小程序应用------嘉俊" ], "summary": "新增或保存", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true }, { "description": "请求参数", "name": "args", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.AppletApplicationSaveReq" } } ], "responses": { "200": { "description": "具体看返回内容", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/login": { "post": { "description": "手机号注册", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "ADMIN" ], "summary": "手机号注册", "parameters": [ { "description": "用户名、验证码", "name": "req", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.LoginReq" } } ], "responses": { "200": { "description": "token", "schema": { "$ref": "#/definitions/md.LoginResponse" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/qiniuyun/upload": { "post": { "description": "七牛云-七牛云上传", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "七牛云" ], "summary": "七牛云上传", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header" }, { "description": "请求参数", "name": "args", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.ImgReqUpload" } } ], "responses": { "200": { "description": "success", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/qualification/bank/save": { "post": { "description": "资质认证-银行资质保存", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "资质认证------嘉俊" ], "summary": "银行资质保存", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true }, { "description": "请求参数", "name": "args", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.MediumBankInfo" } } ], "responses": { "200": { "description": "具体看返回内容", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/qualification/contact/save": { "post": { "description": "资质认证-联系方式保存", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "资质认证------嘉俊" ], "summary": "联系方式保存", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true }, { "description": "请求参数", "name": "args", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.MediumContactInfo" } } ], "responses": { "200": { "description": "具体看返回内容", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/qualification/enterprise/save": { "post": { "description": "资质认证-企业认证保存", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "资质认证------嘉俊" ], "summary": "企业认证保存", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true }, { "description": "请求参数", "name": "args", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.MediumList" } } ], "responses": { "200": { "description": "具体看返回内容", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/qualification/info": { "get": { "description": "资质认证-基本信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "资质认证------嘉俊" ], "summary": "基本信息", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true } ], "responses": { "200": { "description": "具体看返回内容", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/qualification/select/base": { "get": { "description": "资质认证-认证下拉框选择内容", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "资质认证------嘉俊" ], "summary": "认证下拉框选择内容", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true } ], "responses": { "200": { "description": "具体看返回内容", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/role/addAdmin": { "post": { "description": "新增管理员", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "ADMIN-权限管理" ], "summary": "新增管理员", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true }, { "description": "请求参数", "name": "args", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.AddAdminReq" } } ], "responses": { "200": { "description": "success", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/role/addRole": { "post": { "description": "添加角色", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "ADMIN-权限管理" ], "summary": "添加角色", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true }, { "description": "请求参数", "name": "args", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.AddRoleReq" } } ], "responses": { "200": { "description": "success", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/role/adminInfo": { "get": { "description": "管理员信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "ADMIN-权限管理" ], "summary": "管理员信息", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true }, { "type": "string", "description": "管理员id", "name": "adm_id", "in": "query", "required": true } ], "responses": { "200": { "description": "具体看返回内容", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/role/adminList": { "post": { "description": "管理员列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "ADMIN-权限管理" ], "summary": "管理员列表", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true }, { "description": "请求参数", "name": "args", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.AdminListReq" } } ], "responses": { "200": { "description": "具体看返回内容", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/role/bindAdminRole/": { "post": { "description": "管理员绑定角色", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "ADMIN-权限管理" ], "summary": "管理员绑定角色", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true }, { "description": "请求参数", "name": "args", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.BindAdminRoleReq" } } ], "responses": { "200": { "description": "success", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/role/deleteAdmin/{$adm_id}": { "delete": { "description": "删除管理员", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "ADMIN-权限管理" ], "summary": "删除管理员", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true } ], "responses": { "200": { "description": "success", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/role/deleteRole/{$id}": { "delete": { "description": "删除角色", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "ADMIN-权限管理" ], "summary": "删除角色", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true }, { "description": "请求参数", "name": "args", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.UpdateRoleStateReq" } } ], "responses": { "200": { "description": "success", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/role/permissionGroupList": { "get": { "description": "权限组列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "ADMIN-权限管理" ], "summary": "权限组列表", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true }, { "type": "string", "description": "管理员id", "name": "adm_id", "in": "query", "required": true } ], "responses": { "200": { "description": "具体看返回内容", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/role/roleBindPermissionGroup": { "post": { "description": "角色绑定权限组", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "ADMIN-权限管理" ], "summary": "角色绑定权限组", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true }, { "description": "请求参数", "name": "args", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.RoleBindPermissionGroupReq" } } ], "responses": { "200": { "description": "success", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/role/roleList": { "get": { "description": "角色列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "ADMIN-权限管理" ], "summary": "角色列表", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true } ], "responses": { "200": { "description": "具体看返回内容", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/role/updateAdmin": { "post": { "description": "修改管理员信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "ADMIN-权限管理" ], "summary": "修改管理员信息", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true }, { "description": "请求参数", "name": "args", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.UpdateAdminReq" } } ], "responses": { "200": { "description": "success", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/role/updateAdminState": { "post": { "description": "修改管理员状态", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "ADMIN-权限管理" ], "summary": "修改管理员状态", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true }, { "description": "请求参数", "name": "args", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.UpdateAdminStateReq" } } ], "responses": { "200": { "description": "success", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/role/updateRole": { "post": { "description": "修改角色状态", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "ADMIN-权限管理" ], "summary": "修改角色状态", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true }, { "description": "请求参数", "name": "args", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.UpdateRoleStateReq" } } ], "responses": { "200": { "description": "success", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/sms": { "post": { "description": "短信-短信发送", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "短信" ], "summary": "短信发送", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header" }, { "description": "请求参数", "name": "args", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.SmsReq" } } ], "responses": { "200": { "description": "success", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } } }, "definitions": { "md.AddAdminReq": { "type": "object", "required": [ "password", "username" ], "properties": { "memo": { "type": "string" }, "password": { "type": "string" }, "username": { "type": "string" } } }, "md.AddRoleReq": { "type": "object", "required": [ "memo", "name" ], "properties": { "memo": { "type": "string" }, "name": { "type": "string" } } }, "md.AdminListReq": { "type": "object", "properties": { "limit": { "type": "integer" }, "page": { "type": "integer" }, "state": { "type": "integer" }, "username": { "type": "string" } } }, "md.AppletApplicationAdSpaceListData": { "type": "object", "properties": { "ad_id": { "type": "string", "example": "广告位id" }, "app_id": { "type": "string", "example": "小程序appid" }, "cooperate_state": { "type": "string", "example": "合作状态" }, "id": { "type": "string", "example": "id" }, "kind": { "type": "string", "example": "广告位类型" }, "logo": { "type": "string", "example": "logo" }, "memo": { "type": "string", "example": "备注" }, "name": { "type": "string", "example": "应用名称" }, "platform": { "type": "string", "example": "平台" }, "state": { "type": "string", "example": "应用状态 state=2 才能再次编辑" } } }, "md.AppletApplicationAdSpaceListReq": { "type": "object", "properties": { "cooperate_state": { "type": "string", "example": "合作状态" }, "limit": { "type": "string" }, "name": { "type": "string" }, "page": { "type": "string" }, "platform": { "type": "string" } } }, "md.AppletApplicationAdSpaceListRes": { "type": "object", "properties": { "ad_type": { "type": "array", "items": { "$ref": "#/definitions/md.SelectData" } }, "application": { "type": "array", "items": { "type": "object", "additionalProperties": { "type": "string" } } }, "cooperate_state": { "type": "array", "items": { "$ref": "#/definitions/md.SelectData" } }, "list": { "type": "array", "items": { "$ref": "#/definitions/md.AppletApplicationAdSpaceListData" } }, "platform": { "type": "array", "items": { "$ref": "#/definitions/md.SelectData" } }, "state": { "type": "array", "items": { "$ref": "#/definitions/md.SelectData" } }, "total": { "type": "integer" } } }, "md.AppletApplicationAdSpaceSaveReq": { "type": "object", "properties": { "app_id": { "type": "string", "example": "小程序appid" }, "kind": { "type": "string", "example": "广告类型" }, "name": { "type": "string", "example": "应用名称" } } }, "md.AppletApplicationListData": { "type": "object", "properties": { "app_id": { "type": "string", "example": "小程序appid" }, "cooperate_state": { "type": "string", "example": "合作状态" }, "id": { "type": "string", "example": "id" }, "logo": { "type": "string", "example": "logo" }, "memo": { "type": "string", "example": "备注" }, "name": { "type": "string", "example": "应用名称" }, "original_id": { "type": "string", "example": "小程序id" }, "platform": { "type": "string", "example": "平台" }, "state": { "type": "string", "example": "应用状态 state=3 才能再次编辑" } } }, "md.AppletApplicationListReq": { "type": "object", "properties": { "cooperate_state": { "type": "string", "example": "合作状态" }, "limit": { "type": "string" }, "name": { "type": "string" }, "page": { "type": "string" }, "platform": { "type": "string" } } }, "md.AppletApplicationListRes": { "type": "object", "properties": { "cooperate_state": { "type": "array", "items": { "$ref": "#/definitions/md.SelectData" } }, "list": { "type": "array", "items": { "$ref": "#/definitions/md.AppletApplicationListData" } }, "platform": { "type": "array", "items": { "$ref": "#/definitions/md.SelectData" } }, "state": { "type": "array", "items": { "$ref": "#/definitions/md.SelectData" } }, "total": { "type": "integer" } } }, "md.AppletApplicationSaveReq": { "type": "object", "properties": { "app_id": { "type": "string", "example": "小程序appid" }, "id": { "type": "string", "example": "id" }, "logo": { "type": "string", "example": "logo" }, "name": { "type": "string", "example": "应用名称" }, "original_id": { "type": "string", "example": "小程序id" }, "platform": { "type": "string", "example": "平台 微信小程序:wx_applet" } } }, "md.BindAdminRoleReq": { "type": "object", "required": [ "id" ], "properties": { "id": { "type": "integer" }, "role_ids": { "type": "array", "items": { "type": "integer" } } } }, "md.ImgReqUpload": { "type": "object", "properties": { "dir": { "type": "string" }, "file_name": { "type": "string" }, "file_size": { "description": "文件大小, 单位byte", "type": "integer" } } }, "md.LoginPhoneReq": { "type": "object", "required": [ "captcha", "username" ], "properties": { "captcha": { "type": "string", "example": "验证码" }, "username": { "type": "string", "example": "登录账号" } } }, "md.LoginReq": { "type": "object", "required": [ "password", "username" ], "properties": { "code": { "type": "string", "example": "验证码" }, "password": { "type": "string", "example": "登录密码" }, "username": { "type": "string", "example": "登录账号" } } }, "md.LoginResponse": { "type": "object", "properties": { "token": { "type": "string" } } }, "md.MediumBankInfo": { "type": "object", "properties": { "bank": { "type": "string" }, "bank_branch": { "type": "string" }, "bank_no": { "type": "string" }, "currency_conf": { "type": "integer" }, "id": { "type": "integer" }, "licence": { "type": "string" }, "medium_id": { "type": "integer" }, "memo": { "type": "string" }, "state": { "type": "integer" }, "uuid": { "type": "integer" } } }, "md.MediumContactInfo": { "type": "object", "properties": { "address": { "type": "string" }, "email": { "type": "string" }, "id": { "type": "integer" }, "medium_id": { "type": "integer" }, "memo": { "type": "string" }, "name": { "type": "string" }, "phone": { "type": "string" }, "state": { "type": "integer" }, "uuid": { "type": "integer" } } }, "md.MediumList": { "type": "object", "properties": { "business_license_address": { "type": "string" }, "business_license_img_url": { "type": "string" }, "certificate_first_type": { "type": "integer" }, "certificate_type": { "type": "integer" }, "certificate_validity": { "type": "string" }, "company_abbreviation": { "type": "string" }, "company_name": { "type": "string" }, "country_region": { "type": "string" }, "country_region_id": { "type": "integer" }, "id": { "type": "integer" }, "kind": { "type": "integer" }, "legal_representative": { "type": "string" }, "medium_id": { "type": "integer" }, "memo": { "type": "string" }, "registered_address": { "type": "string" }, "registered_address_city_id": { "type": "integer" }, "registered_address_country_id": { "type": "integer" }, "registered_address_county_id": { "type": "integer" }, "registered_address_province_id": { "type": "integer" }, "state": { "type": "integer" }, "unified_social_credit_code": { "type": "string" }, "uuid": { "type": "integer" } } }, "md.Response": { "type": "object", "properties": { "code": { "type": "string", "example": "响应码" }, "data": { "description": "内容" }, "msg": { "type": "string", "example": "具体错误原因" } } }, "md.RoleBindPermissionGroupReq": { "type": "object", "required": [ "role_id" ], "properties": { "permission_ids": { "type": "array", "items": { "type": "integer" } }, "role_id": { "type": "integer" } } }, "md.SelectData": { "type": "object", "properties": { "name": { "type": "string", "example": "名称" }, "value": { "type": "string", "example": "值" } } }, "md.SmsReq": { "type": "object", "properties": { "phone": { "type": "string" }, "type": { "type": "string", "example": "手机号登陆:fast_login 注册:register" } } }, "md.UpdateAdminReq": { "type": "object", "required": [ "id", "password", "username" ], "properties": { "id": { "type": "integer" }, "memo": { "type": "string" }, "password": { "type": "string" }, "username": { "type": "string" } } }, "md.UpdateAdminStateReq": { "type": "object", "required": [ "id", "state" ], "properties": { "id": { "type": "integer" }, "state": { "type": "integer" } } }, "md.UpdateRoleReq": { "type": "object", "required": [ "memo", "name", "role_id" ], "properties": { "memo": { "type": "string" }, "name": { "type": "string" }, "role_id": { "type": "integer" } } }, "md.UpdateRoleStateReq": { "type": "object", "required": [ "role_id", "state" ], "properties": { "role_id": { "type": "integer" }, "state": { "type": "integer" } } } }, "securityDefinitions": { "MasterID": { "type": "apiKey", "name": "MasterID", "in": "header" } } }