{ "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:1003 or advertisement.dengbiao.top", "paths": { "/api/account/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": { "$ref": "#/definitions/md.AccountBase" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/account/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.AgentBankInfo" } } ], "responses": { "200": { "description": "具体看返回内容", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/account/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.AgentContactInfo" } } ], "responses": { "200": { "description": "具体看返回内容", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/account/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.AgentList" } } ], "responses": { "200": { "description": "具体看返回内容", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/account/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/account/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/account/update/password": { "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.AccountUpdatePasswordReq" } } ], "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/login/phone": { "post": { "description": "手机号登入", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "ADMIN" ], "summary": "手机号登陆", "parameters": [ { "description": "用户名、验证码", "name": "req", "in": "body", "required": true, "schema": { "$ref": "#/definitions/md.LoginPhoneReq" } } ], "responses": { "200": { "description": "token", "schema": { "$ref": "#/definitions/md.LoginResponse" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/login/register": { "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/medium/list": { "post": { "description": "媒体中心-媒体列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "媒体中心------嘉俊" ], "summary": "媒体列表", "parameters": [ { "type": "string", "description": "验证参数Bearer和token空格拼接", "name": "Authorization", "in": "header", "required": true } ], "responses": { "200": { "description": "具体看返回内容 data里面的数据", "schema": { "$ref": "#/definitions/md.MediumListRes" } }, "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/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.UpdateRoleReq" } } ], "responses": { "200": { "description": "success", "schema": { "type": "string" } }, "400": { "description": "具体错误", "schema": { "$ref": "#/definitions/md.Response" } } } } }, "/api/role/updateRoleState": { "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.AccountBase": { "type": "object", "properties": { "admin_phone": { "type": "string", "example": "管理员手机号" }, "agent_id": { "type": "string", "example": "账户ID" }, "company_abbreviation": { "type": "string", "example": "公司简称" }, "company_name": { "type": "string", "example": "公司名称" }, "contact_address": { "type": "string", "example": "联系地址" }, "contact_email": { "type": "string", "example": "邮箱" }, "contact_name": { "type": "string", "example": "联系人" }, "contact_phone": { "type": "string", "example": "联系电话" }, "country_region": { "type": "string", "example": "国家地区" }, "currency_conf": { "type": "string", "example": "结算币种" }, "nickname": { "type": "string", "example": "昵称" } } }, "md.AccountUpdatePasswordReq": { "type": "object", "properties": { "captcha": { "type": "string", "example": "验证码" }, "password": { "type": "string", "example": "登录密码" } } }, "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.AgentBankInfo": { "type": "object", "properties": { "agent_id": { "type": "string" }, "bank": { "type": "string" }, "bank_branch": { "type": "string" }, "bank_no": { "type": "string" }, "currency_conf": { "type": "string" }, "id": { "type": "string" }, "licence": { "type": "string" }, "memo": { "type": "string" }, "state": { "type": "string" }, "uuid": { "type": "string" } } }, "md.AgentContactInfo": { "type": "object", "properties": { "address": { "type": "string" }, "agent_id": { "type": "string" }, "email": { "type": "string" }, "id": { "type": "string" }, "memo": { "type": "string" }, "name": { "type": "string" }, "phone": { "type": "string" }, "state": { "type": "string" }, "uuid": { "type": "string" } } }, "md.AgentList": { "type": "object", "properties": { "agent_id": { "type": "string" }, "business_license_address": { "type": "string" }, "business_license_img_url": { "type": "string" }, "certificate_first_type": { "type": "string" }, "certificate_type": { "type": "string" }, "certificate_validity": { "type": "string" }, "company_abbreviation": { "type": "string" }, "company_name": { "type": "string" }, "country_region": { "type": "string" }, "country_region_id": { "type": "string" }, "id": { "type": "string" }, "kind": { "type": "string" }, "legal_representative": { "type": "string" }, "memo": { "type": "string" }, "registered_address": { "type": "string" }, "registered_address_city_id": { "type": "string" }, "registered_address_country_id": { "type": "string" }, "registered_address_county_id": { "type": "string" }, "registered_address_province_id": { "type": "string" }, "state": { "type": "string" }, "unified_social_credit_code": { "type": "string" }, "uuid": { "type": "string" } } }, "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.MediumListData": { "type": "object", "properties": { "account": { "type": "string", "example": "媒体账号" }, "business_license_address": { "type": "string", "example": "营业执照地址" }, "company_name": { "type": "string", "example": "公司名称" }, "id": { "type": "string", "example": "id" }, "legal_representative": { "type": "string", "example": "法定代表人" }, "medium_id": { "type": "string", "example": "媒体id" }, "memo": { "type": "string", "example": "备注 审核时填写的" }, "state": { "type": "string", "example": "状态(0:待提交 1:待审核 2:审核通过 3:审核拒绝)" }, "unified_social_credit_code": { "type": "string", "example": "统一社会信用代码" } } }, "md.MediumListRes": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/definitions/md.MediumListData" } }, "state": { "type": "array", "items": { "$ref": "#/definitions/md.SelectData" } }, "total": { "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 修改密码:update_password" } } }, "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" } } }