主题

创建服务并授权 3.3.2+ ​

接口说明 ​

请求URL：http[s]://{网关地址}/minos-platform/service/add

请求方式： POST

请求内容类型： application/json

响应内容类型： application/json

请求说明 ​

请求体 ​

参数名必填类型描述
appWidMString应用wid
serviceNameMString服务默认名称
serviceNameLangKeysOList<ExMultiLangData>服务名称多语言List
serviceDescOString服务默认说明
serviceDescLangKeysOList<ExMultiLangData>服务说明多语言List
serviceStationMInteger服务平台
0：pc
1：移动
2：PCand移动
pcIconUrl*MStringPC图标的base64编码，png图片，大小不超过200kb，尺寸不超过216*216px.当serviceStation为[0或2]时，为必填
mobileIconUrl*MString移动图标的base64编码，png图片，大小不超过200kb，尺寸不超过96*96px.当serviceStation为[1或2]时，为必填
pcUrl*MStringpc地址.当serviceStation为[0或2]时，为必填
mobileUrl*MString移动地址.当serviceStation为[1或2]时，为必填
guestVisibilityMString登录前可见性
0:可见
1:不可见
loginVisibilityMString登陆后可见性
0:所有人可见
1:可用即可见
2:所有人不可见
serviceGrantInfosOList<ExServiceGrant>服务授权信息集合，为空则不授权 （只可授权给用户组）
userAccountListOList<String>服务授权的用户账号集合
serviceClassifyIds3.7.1.SP6+OList<String>服务关联的服务分类Id
servOnlineDay3.5.4.Beta3-OString服务上线日，用于描述服务周期.合法值1-31
servOfflineDay3.5.4.Beta3-OString服务下线日，用于描述服务周期.合法值1-31
servOnlineMonth3.5.4.Beta3-OString服务上线月，用于描述服务周期.合法值1-12
servOfflineMonth3.5.4.Beta3-OString服务下线月，用于描述服务周期.合法值1-12
servOnlineYear3.5.4.Beta3-OString服务上线年，用于描述服务周期.合法值1-9999
servOfflineYear3.5.4.Beta3-OString服务下线年，用于描述服务周期.合法值1-9999
servPeriodEnabled3.5.4.Beta3+OString是否启用服务周期
0：关闭 （默认）
1：开启
servPeriods3.5.4.Beta3+OList<ExServicePeriodInfo>要配置的服务周期列表。
outPeriodVisibility3.6.1.SP6+OInteger服务周期外可见性
0：不可见（默认）
1：可见
若选择可见，即使当前月份非服务的周期，也可以在门户中查看到该服务
enableQuickProcessing 3.8.1.Beta1+MInteger是否支持快捷办理：0:不支持；1：支持
formParamList 3.8.1.Beta1+MList<FormParamModel>表单参数模型
formUrl 3.8.1.Beta1+OString表单地址，为空默认取pcUrl
mobileFormUrl 3.8.1.Beta1+OString移动表单地址，为空默认取formUrl
thirdPartyAuthUrl3.8.1.Beta1+OString第三方系统鉴权地址
formButtons3.8.1.Beta1+OList<String>表单交互按钮，可用值为：submit、cancel、reset，默认全部渲染
isMatchNewColumn3.8.2.Beta2+OBoolean是否匹配新字段，这个字段为true，才会保存办事指南字段，受必填字段控制，默认 false
linkType3.8.2.Beta2+OInteger关联的数据类别 1：第三方链接地址 2:办理须知
linkedExtraService3.8.2.Beta2+OExLinkedExtraService关联的数据
dealGuideColumnList3.8.2.Beta2+*MList<ExServiceColumn>办事指南字段
userAccount3.8.2.Beta2+*MString操作人账号(流程需要，流程开启时必填)
qywxMobileUrl3.8.2.Beta2+OString企业微信移动端地址
roleList3.8.2.Beta2+*MList<ExServiceRoleInfo>服务对象
miniProgramUrl3.8.2.Beta2+*MString小程序地址
miniProgramUrlDesc3.8.2.Beta2+*MString小程序地址描述
miniUrlDescLangKeys3.8.2.Beta2+*MList<ExMultiLangData>小程序地址描述多语言
dutyDeptWid3.8.2.Beta2+*MString责任部门wid
contactsAccount3.8.2.Beta2+*MString服务责任人
serviceGuide3.8.2.Beta2+*MString服务指南
serviceGuideLangKeys3.8.2.Beta2+*MList<ExMultiLangData>服务指南多语言
outSchoolVisit3.8.2.Beta2+*MInteger外部联系人访问限制是否启用 1 启用 0 禁用
servRecommendPeriods3.8.2.Beta2+*MList<ExServiceRecommendPeriodInfo>服务推荐周期
recommendPeriodsEnabled3.8.2.Beta2+OString是否启用服务推荐周期
0：关闭 （默认）
1：开启
bizType3.8.3+Oint服务类型：0-普通服务，1-智能体服务，不传默认普通服务
contactInfo3.8.3.SP4+*MString联系方式

ExServiceRecommendPeriodInfo

字段名必填类型描述
servOnlineDay*MString服务上线日，yyyy-MM-dd。取值与repeatUnit相关。repeatUnit为0时，年月日均不可置null；为1时，年值置null；为2时，年值、月值均置null；
servOfflineDay*MString服务下线日，yyyy-MM-dd。取值与repeatUnit相关。repeatUnit为0时，年月日均不可置null；为1时，年值置null；为2时，年值、月值均置null；
repeatUnitMString服务周期，0为不重复，1为按年重复，2为按月重复

ExServiceRoleInfo

参数名必填类型描述
widMString服务对象 wid

ExServiceColumn

参数名必填类型描述
widMString字段主键
columnValueListMList<ExServiceColumnValue>字段值

ExServiceColumnValue

参数名必填类型描述
columnWidMString字段主键
columnValueMObject字段值（中文，具体类型见示例）
columnValueMultiLangMList<ExMultiLangData>字段值多语言，必须有中文数据(langCountry为 zh_CN 的数据)

ExLinkedExtraService

参数名必填类型描述
relativeLinkTypeMString支持的类型，受管控台服务管理方式配置控制 1：第三方链接地址 2:办理须知 都支持则为1,2
linkUrlMString第三方系统PC访问地址 当linkType为1时必填
linkMobileUrlMString第三方系统移动访问地址 当linkType为1时必填
buttonNameMString第三方链接地址按钮名称 当linkType为1时必填
instructionsButtonNameMString办理须知按钮名称 当linkType为2时必填
instructionsMList<ExMultiLangData>办理须知内容 当linkType为2时必填 必须有中文数据(langCountry为 zh_CN 的数据)

ExMultiLangData

参数名必填类型描述
langValueMString属性值
langCountryMString语言类型

ExServiceGrant

字段名必填类型描述
grantTypeMString1：用户组 （只可授权给用户组）
grantWidMString对应的用户组wid

ExServicePeriodInfo

字段名必填类型描述
servOnlineDay*MString服务上线日，yyyy-MM-dd。取值与repeatUnit相关。repeatUnit为0时，年月日均不可置null；为1时，年值置null；为2时，年值、月值均置null；为3时，无需传值
servOfflineDay*MString服务下线日，yyyy-MM-dd。取值与repeatUnit相关。repeatUnit为0时，年月日均不可置null；为1时，年值置null；为2时，年值、月值均置null；为3时，无需传值
servOnlineDayTime3.7.4.SP2+*MString服务上线时分，HH:mm。取值与repeatUnit相关，当repeatUnit为3时必填
servOfflineDayTime3.7.4.SP2+*MString服务下线时分，HH:mm。取值与repeatUnit相关，当repeatUnit为3时必填
repeatUnitMString服务周期，0为不重复，1为按年重复，2为按月重复，3为按天重复（3.7.4.SP2+）

FormParamModel

字段名必填类型描述
paramCodeMString表单参数code
paramNameMString表单参数名称
paramDescMString表单参数描述，如果有特殊的格式，要在描述中说明，比如时间格式要求为”yyyy-MM-dd“
dataTypeMString参数数据类型
defaultValueOString默认值

请求示例 ​

json
{
"appWid": "942780471854215168",
"serviceName": "服务名称",
// 服务名称多语言信息，非必填
"serviceNameLangKeys": [
{
"wid": "",
"langKey": "",
"langValue": "V2测试",
"languageName": "英文",
"langCountry": "en"
}
],
"serviceDesc": "服务描述非必填",
// 服务描述多语言信息，非必填
"serviceDescLangKeys": [
{
"wid": "",
"langKey": "",
"langValue": "V2测试",
"languageName": "英文",
"langCountry": "en"
}
],
// 服务平台类型为2，2代表创建pc、mobile服务
"serviceStation": "2",

    // 当serviceStation为[0或2]时，为必填
    "pcIconUrl": "base64编码的pc图标",
    
    // 当serviceStation为[1或2]时，为必填
    "mobileIconUrl": "base64编码的mobile图标",
    
    // 当serviceStation为[0或2]时，为必填
    "pcUrl": "http://1.comhttp://1.com",
    
    // 当serviceStation为[1或2]时，为必填
    "mobileUrl": "http://1.comhttp://1.com",
    "guestVisibility": "0",
    "loginVisibility": "1",
    // 只可授权给用户组
    "serviceGrantInfos": [
    	{
    		"grantType": "1",
            "grantWid": "879801177372512256"
    	}
    ],
    "serviceClassifyIds":["111", "222"],
    "userAccountList":["11212", "3242"],
    "servPeriods":[
        {
            "servOnlineDay":"null-05-08",
            "servOfflineDay":"null-06-08",
            "repeatUnit":"1"
        },
        {
            "servOnlineDay":"null-null-18",
            "servOfflineDay":"null-null-28",
            "repeatUnit":"2"
        }
    ],
    "servPeriodEnabled":"0",
    "outPeriodVisibility": 1,
  //  是否支持快捷办理
  "enableQuickProcessing": 1,
  // 表单数据模型
  "formParamList": [
    {
      "paramCode": "createTime",
      "paramName": "创建时间",
      "paramDesc": "创建时间，格式yyyy-MM-dd",
      "dataType": "String",
      "defaultValue": "2020-01-01"
    }
  ],
  // 为空默认取pcUrl
  "pcFormUrl": "http://form.comhttp://1.com",
  // 为空默认取pcFormUrl
  "mobileFormUrl":"http://form.comhttp://1.com",

  // 鉴权地址
  "thirdPartyAuthUrl": "http://form.comhttp://1.com",
  "formButtons": [ "submit", "cancel"],
  "userAccount":"ampadmin",
  "dutyDeptWid":"1011640991665106948",
  "contactsAccount":"ampadmin",
  "roleList":[
    {"wid":"1410616977736302592"},
    {"wid":"1412448703627808782"}
  ],
  "isMatchNewColumn":true,
  "dealGuideColumnList":[
    {
      "wid":"DEAL_TIME_LIMIT",
      "columnName":"办理时限",
      "columnValueList":[
        {
          "columnId":"DEAL_TIME_LIMIT",
          "columnValue":{
            "type":"2",
            "value":"新办理时限"
          },
          "columnValueMultiLang":[
            {
              "langCountry":"zh_CN",
              "langValue":"{\"type\":\"2\",\"value\":\"新办理时限\"}"
            }
          ]
        }
      ]
    },
    {
      "wid":"PROCESS_FLOW",
      "columnName":"办理流程",
      "columnValueList":[
        {
          "columnId":"PROCESS_FLOW",
          "columnValue":{
            "comments":"这是办理流程2222",
            "picType":"2",
            "thirdUrl":"http://172.16.29.60:8811/oss/iconLab/2025-07-01/bg.1499fb-1389658897671929856.jpg?sign=ik7EjkjtP1sa3x6-dOdz71WipOewRJzB58t-7w4IPXnEihD6MVNCzF0oTF8XfYrX42sAwhvrDglR-Cdt9V_kYA"
          },
          "columnValueMultiLang":[
            {
              "langCountry":"zh_CN",
              "langValue":"{\"picType\":\"2\",\"thirdUrl\":\"http://172.16.29.60:8811/oss/iconLab/2025-07-01/bg.1499fb-1389658897671929856.jpg?sign=ik7EjkjtP1sa3x6-dOdz71WipOewRJzB58t-7w4IPXnEihD6MVNCzF0oTF8XfYrX42sAwhvrDglR-Cdt9V_kYA\",\"comments\":\"这是办理流程22222\"}"
            } ,
            {
              "langCountry":"en",
              "langValue":"{\"picType\":\"2\",\"thirdUrl\":\"http://172.16.29.60:8811/oss/iconLab/2025-07-01/bg.1499fb-1389658897671929856.jpg?sign=ik7EjkjtP1sa3x6-dOdz71WipOewRJzB58t-7w4IPXnEihD6MVNCzF0oTF8XfYrX42sAwhvrDglR-Cdt9V_kYA\",\"comments\":\"这是办理流程1111英文\"}"
            }
          ]
        }
      ]
    },
    {
      "wid":"RELATED_MATERIALS",
      "columnName":"相关材料",
      "columnValueList":[
        {
          "columnId":"RELATED_MATERIALS",
          "columnValue":{
            "material_comments":"这是个相关材料变更.jpg",
            "fileUrl":"http://172.16.29.60:8811/oss/iconLab/2025-07-01/logo-1389550554915684352.png?sign=o_CQMEYFA2FRBmomdoQs4txIKYS4WzmDUkfKBst47LISqT5faZ_-AkdXzJpErJZZJRtUO77S2GiW4-kUl1kYtA"
          },
          "columnValueMultiLang":[
            {
              "langCountry":"zh_CN",
              "langValue":"{\"material_comments\":\"这是个相关材料名称变更.jpg\",\"fileUrl\":\"http://172.16.29.60:8811/oss/iconLab/2025-07-01/logo-1389550554915684352.png?sign=o_CQMEYFA2FRBmomdoQs4txIKYS4WzmDUkfKBst47LISqT5faZ_-AkdXzJpErJZZJRtUO77S2GiW4-kUl1kYtA\"}"
            } ,
            {
              "langCountry":"en",
              "langValue":"{\"material_comments\":\"这是个相关材料英文名称.jpg\",\"fileUrl\":\"http://172.16.29.60:8811/oss/iconLab/2025-07-01/logo-1389550554915684352.png?sign=o_CQMEYFA2FRBmomdoQs4txIKYS4WzmDUkfKBst47LISqT5faZ_-AkdXzJpErJZZJRtUO77S2GiW4-kUl1kYtA\"}"
            }
          ]
        }
      ]
    },
    {
      "wid":"CONTACT_PHONE",
      "columnName":"咨询电话",
      "columnValueList":[
        {
          "columnId":"CONTACT_PHONE",
          "columnValue":{
            "comments":"咨询电话123名称变更变更变更变更",
            "phone":"111222233344变更变更变更变更"
          },
          "columnValueMultiLang":[
            {
              "langCountry":"zh_CN",
              "langValue":"{\"phone\":\"111232233443变更变更变更变更\",\"comments\":\"咨询电话123名称变更变更变更变更\"}"
            } ,
            {
              "langCountry":"en",
              "langValue":"{\"phone\":\"111232233443\",\"comments\":\"咨询电话123英文英文变更\"}"
            }
          ]
        }
      ]
    },
    {
      "wid":"FAQS",
      "columnName":"常见问题",
      "columnValueList":[
        {
          "columnId":"FAQS",
          "columnValue":{
            "answer":"这是常见答案变更",
            "question":"这是常见问题变更"
          },
          "columnValueMultiLang":[
            {
              "langCountry":"zh_CN",
              "langValue":"{\"question\":\"这是常见问题变更\",\"answer\":\"这是常见答案变更\"}"
            } ,
            {
              "langCountry":"en",
              "langValue":"{\"question\":\"这是常见问题英文变更\",\"answer\":\"这是常见答案英文变更\"}"
            }
          ]
        }
      ]
    },
    {
      "wid":"DEAL_ADDRESS",
      "columnName":" 办理地点",
      "columnValueList":[
        {
          "columnId":"DEAL_ADDRESS",
          "columnValue":{
            "siteName":"南京"
          },
          "columnValueMultiLang":[
            {
              "langCountry":"zh_CN",
              "langValue":"{\"siteName\":\"南京\"}"
            }
          ]
        }
      ]
    },
    {
      "wid": "HANDLING_METHOD",
      "columnName": "办理方式(columnValue中的值从获取服务字段字典接口中取)",
      "columnValueList": [
        {
          "columnId": "HANDLING_METHOD",
          "columnValue": [
            "3991919224",
            "7657816493"
          ]
        }
      ]
    }


  ],
  "linkType":1,
  "linkedExtraService":{
    "relativeLinkType":"1,2",
    "linkUrl":"http://172.16.72.161:8091/router/manageTool/serviceManage",
    "linkMobileUrl":"http://172.16.72.161:8091/router/manageTool/serviceManage",
    "buttonName":"这是个按钮诶",

    "instructionsButtonName":"办理须知",
    "instructions":[{
      "langCountry":"zh_CN",
      "langValue":"办理须知办理须知办理须知办理须知办理须知办理须知办理须知办理须知办理须知办理须知"
    }]
  },
  "qywxMobileUrl":"/456784234242342",
  "serviceGuide":"服务指南变更变更变更变更",
  "serviceGuideLangKeys":[
    {
      "langCountry":"en",
      "langValue":"服务指南英文变更变更变更变更"
    }
  ],
  "miniProgramUrl":"小程序地址",
  "miniProgramUrlDesc":"小程序地址描述",
  "miniUrlDescLangKeys":[
    {
      "langCountry":"en",
      "langValue":"小程序地址描述"
    }
  ]
}

响应说明 ​

响应体 ​

字段名类型描述
errcodeString返回码，0 成功
errmsgString返回码描述
dataExServiceBase服务信息

ExServiceBase

参数名类型描述
widString主键
appWidString应用wid
serviceNameString服务默认名称
serviceNameLangKeyString服务名称多语言标识
serviceNameLangKeysList<ExMultiLangData>服务名称多语言List
serviceDescString服务默认说明
serviceDescLangKeyString服务说明多语言ID
serviceDescLangKeysList<ExMultiLangData>服务说明多语言List
serviceTypeInteger服务类型 0：手工 1：接入 2：单体
serviceStationInteger服务平台 0：pc 1：移动
pcIconUrlStringPC图标URL
pcIconPathStringPC图标目录
pcIconNameStringPC图标名称
mobileIconUrlString移动图标URL
mobileIconPathString移动图标目录
mobileIconNameString移动图标名称
pcUrlStringpc地址
mobileUrlString移动地址
guestVisibilityString登录前可见性
loginVisibilityString登陆后可见性
serviceGrantInfosList<ExServiceGrant>应用授权信息集合

响应示例 ​

json
{
    "errcode": "0",
    "errmsg": "success",
    "data": {
        "wid": "994300417510477824",
        "serviceName": "tlsun",
        "serviceNameLangKey": "994300417544032256",
        "serviceNameLangKeys": [
            {
                "wid": "994300417544032257",
                "sourceType": "0",
                "langKey": "994300417544032256",
                "langValue": "tlsun",
                "langCountry": "zh_CN"
            }
        ],
        "serviceDesc": "",
        "serviceDescLangKey": "994300417774718976",
        "serviceDescLangKeys": null,
        "serviceType": 0,
        "serviceStation": 2,
        "pcIconUrl": "http://172.16.34.144:8811/oss/iconLab/2022-07-06/QQ截图20220706093413-994300319317626880.png?sign=-YeA3acV2D4saAGfUbPob4pLPGhHiWtNeaZlDHydKphkgDjruCsDQh_yRzmQwuzF",
        "pcIconPath": "2022-07-06",
        "pcIconName": "QQ截图20220706093413-994300319317626880.png",
        "mobileIconUrl": "http://172.16.34.144:8811/oss/iconLab/2022-07-06/QQ截图20220706172718-994293522502520832.png?sign=KeQ_VYE4T0WPDxAWEqLgMJ3c1Ewd5Yi_P4jzHdibjY5ADXr7KnD7KejikS98Pasr",
        "mobileIconPath": "2022-07-06",
        "mobileIconName": "QQ截图20220706172718-994293522502520832.png",
        "pcUrl": "/test1",
        "mobileUrl": "/test12",
        "guestVisibility": "0",
        "loginVisibility": "1",
        "serviceGrantInfos": [
            {
                "grantType": "-1",
                "grantWid": "school"
            }
        ],
        "serviceClassifyIds": null,
        "userAccountList": null,
        "appWid": "994299008270471168"
    }
}

错误码 ​

错误码描述
111001必填参数不能为空
111003字段长度超过范围；单个服务最多只允许设置十个服务周期
111012请传入格式为.png的图片
111015移动端、pc端服务缺少移动端、pc端图标/地址
999统一错误码，详细描述信息参见接口返回

Demo ​

java
// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
ServiceAddRequest request = new ServiceAddRequest();
request.setAppWid("1240714452991864832");
request.setServiceName("service001");
request.setServiceNameLangKeys(Stream.of(new MultiLangDataInfo("english name 001","en")).collect(Collectors.toList()));
//        request.setServiceDesc();
//        request.setServiceDescLangKeys();
request.setServiceStation(0);
File file = new File("C:\\Users\\sltang\\Pictures\\logo.png");
//图片转成base64
request.setPcIconUrl(FileUtil.fileToBase64(file));
//        request.setMobileIconUrl();
request.setPcUrl("/a");
//        request.setMobileUrl();
request.setGuestVisibility("0");
request.setLoginVisibility("0");
request.setServiceGrantInfos(Stream.of(new ServiceGrantInfo("1","1266059229438275584")).collect(Collectors.toList()));
request.setUserAccountList(Stream.of("campususertest001").collect(Collectors.toList()));
//        request.setServiceClassifyIds();
request.setServPeriodEnabled("1");
request.setServPeriods(Stream.of(new ServicePeriodInfo("null-05-08","null-06-08","1")).collect(Collectors.toList()));
//        request.setOutPeriodVisibility();

BaseResponse response = client.execute(request);
//调用成功，则处理业务逻辑
if (response.isSuccess()) {
	//.....
}

江苏金智教育信息股份有限公司

Copyright © Jiangsu Wisedu System Co.,Ltd. All Rights Reserved. 2025 版权所有