• [WeLink&开放平...] WeLink开放平台企业内部应用服务端API--通讯录--查询部门详情
    通过部门Id获取部门详细信息,如部门名称、上级部门、部门的主管。请求格式说明请求方式: GET (HTTPS)请求地址: https://open.welink.huaweicloud.com/api/contact/v1/departments/{deptcode}认证方式: access_token,请参考获取access_token请求头部:x-wlk-Authorization: access_token请求参数:  参数说明deptCode部门编码,从用户详细信息中获取部门编码请求示例:curl  -H "x-wlk-Authorization: access_token" https://open.welink.huaweicloud.com/api/contact/v1/departments/{deptcode}响应格式说明返回结果:  {  "code": "0",  "message": "ok",  "deptCode": "10001",  //部门Id, Key值   "deptNameCn": "开发部",  //部门中文名称   "deptNameEn": "Development Dept",  //部门英文名称   "parentCode": 10000,  //上级部门ID   "managerAccount": "zhangshan@welink"  //部门主管(员工帐号)}返回参数说明:参数说明code数据正常返回“0”,如果发生错误,会返回对应的错误码。message返回信息,包括接口请求发生错误时的详细信息。deptCode部门Id, Key值deptNameCn部门中文名称deptNameEn部门英文名称parentCode上级部门IDmanagerAccount部门主管(员工帐号)错误码说明:错误码说明47001当前登录用户信息获取失败47009无数据500系统错误
  • [WeLink&开放平...] WeLink开放平台企业内部应用服务端API--通讯录--查询人员信息同步结果
    查询异步批量同步用户的结果请求格式说明请求方式:POST (HTTPS)请求地址:https://open.welink.huaweicloud.com/api/contact/v1/users/status 认证方式: access_token,请参考获取access_token请求头部:Accept-Charset:UTF-8 Content-Type:application/json x-wlk-Authorization:access_token请求参数:  {   "personInfo": [         {            "corpUserId": "111"         },         {            "mobileNumber": "186xxxxxxxx"         }     ] }请求参数说明:  参数参数类型必填说明corpUserIdString特殊可选该用户在租户自身系统的登录标识,用于认证和邮箱登录(客户内唯一)。corpUserId、mobileNumber和userEmail不可同时为空mobileNumberString特殊可选手机号码。corpUserId、mobileNumber和userEmail不可同时为空userEmailString特殊可选邮箱。corpUserId、mobileNumber和userEmail不可同时为空请求示例:  curl -X POST \   'https://open.welink.huaweicloud.com/api/contact/v1/users/status' \   -H 'Accept-Charset: UTF-8' \   -H 'Content-Type: application/json' \   -H 'x-wlk-Authorization: access_token' \   -d '{"请求参数 json格式"}'响应格式说明返回结果:正常返回结果:{    "code": "0",    "message": "success",    "data": [         {            "corpUserId": "xxxxx",            "code": "47107",            "message": " No need to operate, just save into the admin table"         },         {            "corpUserId": "xxxxx",            "code": "47109",            "message": " Operation success"         },         {            "corpUserId": "xxxxx",            "code": "47110",            "message": " Failed to get the company email suffix information."         },         {            "corpUserId": "xxxxx",            "code": "47111",            "message": " Account not exist."         }     ] }异常返回结果:{     "code": "47103",     "message": "Authentication failed",     "data": [] }返回参数说明:参数说明code数据正常返回“0”,如果发生错误,会返回对应的错误码。message返回信息,包括接口请求发生错误时的详细信息。datacorpUserId:该用户在租户自身系统的登录标识,用于认证和邮箱登录(客户内唯一);code:状态码;message:状态描述错误码说明:错误码说明0成功47003参数为空(邮箱不能为空,部门信息不能为空等)47004参数不对(邮箱格式有误,手机号码有误等)47100待处理47101Token格式错误47102无权限47103Token过期47104处理中47105秘书帐号未创建47106上级部门未创建47107未开户(仅保存成功)47108开户中47109开户成功47110开户失败(携带失败原因)47111账户不存在47112处理中(无须再提交此数据)47113待处理(无须再提交此数据)
  • [WeLink&开放平...] WeLink开放平台企业内部应用服务端API--通讯录--异步批量同步用户
    接受用户信息,异步同步到WeLink通讯录,支持批量更新用户信息,每次请求最多支持10个用户。此接口为异步接口,返回的信息仅表明参数是否合法,是否同步成功请访问查询用户异步同步结果接口查询 。请求格式说明请求方式:POST (HTTPS)请求地址:https://open.welink.huaweicloud.com/api/contact/v1/users/bulk认证方式: access_token,请参考获取access_token请求头部:Accept-Charset:UTF-8 Content-Type:application/json x-wlk-Authorization:access_token请求参数:  {      "personInfo": [         {             "corpUserId": "111",             "userNameCn" : "张三",             "userNameEn": "zhangsan",             "sex": "F",             "mobileNumber": "+86-15115127336",             "phoneNumber": "+86-15115127336",             "corpDeptCode": "1000",             "userEmail": "zhangsan@huawei.com",             "landlineNumber": "",             "addressCode": "1000",             "corpSecretary": "",             "isOpenAccount": "1",             "address": "中国深圳",             "remark": "test",             "valid": "1",             "isHideMobileNumber": "1",             "orderInDepts": "26"         }     ] }请求参数说明:  参数参数类型必填说明corpUserIdString是该用户在租户自身系统的登录标识,用于认证和邮箱登录(客户内唯一)userNameCnString是人员中文名称userNameEnString否人员英文名称sexString是性别。仅:M/F,  M: 男, F: 女mobileNumberString是绑定手机号码phoneNumberString是手机号码corpDeptCodeString是客户侧部门唯一编码,请先完成部门信息同步,否则传递该字段,系统无法识别该用户的部门userEmailString否邮箱landlineNumberString否座机addressCodeString否邮政编码corpSecretaryString否秘书。在导入用户时,如果秘书帐号还不存在,需要先维护秘书用户信息,再重新同步isOpenAccountString是“1”:表示开户,“0”:表示仅同步不开户addressString否办公位置信息remarkString否备注信息validString是默认为"1", "0"表示该用户已被移除即销户isHideMobileNumberString否是否隐藏手机号码。1:公开(默认);2:隐藏orderInDeptsString否人员在所在部门内排序。取值范围:1~9999。按数值正序排列。默认为10000。emailLoginAccountString否EAS邮箱可以维护用户的域账号用来支持邮箱登录请求示例:  curl -X POST \   'https://open.welink.huaweicloud.com/api/contact/v1/users/bulk' \   -H 'Accept-Charset: UTF-8' \   -H 'Content-Type: application/json' \   -H 'x-wlk-Authorization: access_token' \   -d '{"请求参数 json格式"}'响应格式说明返回结果:正常返回结果:{    "code": "0",    "message": "成功",    "data": [         {            "corpUserId": "vvvvv",            "code": "47100",            "message": "waiting for deal"         },         {            "corpUserId": "vvvvdvdvd",            "code": "47003",            "message": "The mobile number used for login is empty. "         },         {            "corpUserId": "n",            "code": "47004",            "message": "isOpenAccount must be 1 or 0"         }     ] }异常返回结果:{     "code": "47101",     "message": "token格式错误",     "data": [     ] }返回参数说明:参数说明code数据正常返回“0”,如果发生错误,会返回对应的错误码。message返回信息,包括接口请求发生错误时的详细信息。datacorpUserId:该用户在租户自身系统的登录标识,用于认证和邮箱登录(客户内唯一);code:状态码;message:状态描述错误码说明:错误码说明0成功47003参数为空(邮箱不能为空,部门信息不能为空等)47004参数不对(邮箱格式有误,手机号码有误等)47100待处理47101Token格式错误47102无权限47103Token过期47104处理中47105秘书帐号未创建47106上级部门未创建47107未开户(仅保存成功)47108开户中47109开户成功47110开户失败(携带失败原因)47111账户不存在47112处理中(无须再提交此数据)47113待处理(无须再提交此数据)47120登录手机号已被注册
  • [WeLink&开放平...] WeLink开放平台企业内部应用服务端API--通讯录--查询部门的人员信息列表(详细信息)
    根据部门ID获取部门内所有用户的详细信息列表,支持分页查询。请求格式说明请求方式: GET (HTTPS)请求地址: https://open.welink.huaweicloud.com/api/contact/v1/user/users认证方式: access_token,请参考获取access_token请求头部:Accept-Charset:UTF-8 Content-Type:application/json x-wlk-Authorization:access_token请求参数说明:  参数名参数说明类型必选deptCode部门编码。从用户详细信息中获取部门编码string是pageNo当前页数。默认为1string否pageSize每页显示数量。默认为10(不能大于50)string否请求示例:curl -X GET "https://open.welink.huaweicloud.com/api/contact/v1/user/users?deptCode=3003" -H "Accept-Charset: utf-8" -H "x-wlk-Authorization: access_token"响应格式说明正常返回结果{    "code": "0",    "message": "OK",    "pageNo": 1,    "pages": 1,    "pageSize": "10",    "total": 2,    "data": [{          "userStatus": "1",                     //状态, 1:未开户,2:开户中,3:已开户,4:已销户           "userId": "zhangsan1@welink",       //用户帐号, Key值           "deptCode": "10001",                   //部门Id, Key值, 必填           "deptNameCn": "72270测试部门",          "deptNameEn": "72270Test Dept",          "mobileNumber": "+86-15811847236",     //绑定手机号码, 必填           "phoneNumber": "+86-15811847236",      //手机号码           "landlineNumber": "0755-88888888",     //电话号码(座机)           "userNameCn": "张三",                  //用户中文名称, 必填           "userNameEn": "zhangshan",            //用户英文名称, 必填           "sex": "M",                           //性别, 仅:M/F, M: 男, F: 女, 必填           "corpUserId": "36188",                //用户工号(集成用的字段,如果在开户时没有维护则为空)           "userEmail": "zhangshan4@126.com",    //用户邮箱, 必填           "secretary": "zhangshan@welink",   //秘书(用户帐号)           "address": "广东省深圳",               //地址           "remark": "欢迎加入WeLink",        //备注           "creationTime": "2018-05-03 13:58:02",  //创建时间           "lastUpdatedTime": "2018-05-03 13:58:02"  //最后更新时间         },         {          "userStatus": "1",                   //状态, 1:未开户2:开户中3:已开户4已销户           "userId": "zhangsan1@welink",     //用户帐号, Key值           "deptCode": "10001",                //部门Id, Key值, 必填           "deptNameCn": "72270测试部门",          "deptNameEn": "72270Test Dept",          "mobileNumber": "+86-15811847236",  //绑定手机号码, 必填           "phoneNumber": "+86-15811847236",   //手机号码           "landlineNumber": "0755-88888888",  //电话号码(座机)           "userNameCn": "张三",              //用户中文名称, 必填           "userNameEn": "zhangshan",        //用户英文名称, 必填           "sex": "M",                       //性别, 仅:M/F, M: 男, F: 女, 必填           "corpUserId": "36188",            //用户工号(集成用的字段,如果在开户时没有维护则为空)           "userEmail": "zhangshan4@126.com",  //用户邮箱, 必填           "secretary": "zhangshan@welink", //秘书(用户帐号)           "address": "广东省深圳",             //地址           "remark": "欢迎加入WeLink",       //备注           "creationTime": "2018-05-03 13:58:02",  //创建时间           "lastUpdatedTime": "2018-05-03 13:58:02"  //最后更新时间         }     ] }异常返回结果  {    "code": 47101,    "message": "Token格式错误",    "data": []   }返回参数说明:参数名必选类型参数说明code是string数据正常返回“0”,如果发生错误,会返回对应的错误码message是string返回信息,包括接口请求发生错误时的详细信息pageNo是int当前页数pages是int总共页数pageSize是string每页显示数量total是int总数量data否array用户信息:>> userStatus: 状态>> userId: 用户账号>> deptCode : 部门编码>> deptNameCn : 部门中文名称>> deptNameEn : 部门英文名称>> mobileNumber : 绑定手机号码>> phoneNumber: 手机号码>> landlineNumber: 电话号码(座机)>> userNameCn: 用户中文名称>> userNameEn: 用户英文名称>> sex : 性别>> corpUserId: 员工工号(企业内唯一标识)>> userEmail: 邮箱>> secretary: 秘书(用户帐号)>> address: 地址>> remark: 备注>> creationTime: 创建时间>> lastUpdatedTime: 最后更新时间错误码说明:错误码说明47000无权限47001当前登录用户信息获取失败47002部门编码为空47003参数为空47004参数不对47007当前登录者是非法用户或个人详情已失效47008参数校验不通过47009提交失败47012无数据47013查询数量限制47100待处理47101Token格式错误47102无权限47103Token过期47104处理中47105秘书账号未创建47106上级部门未创建500系统错误
  • [WeLink&开放平...] WeLink开放平台企业内部应用服务端API--通讯录--查询部门的人员信息列表(简单信息)
    根据部门id获取部门内所有用户简单信息(如用户id,用户中文名称,用户英文名称)列表,支持分页查询。请求格式说明请求方式: GET (HTTPS)请求地址: https://open.welink.huaweicloud.com/api/contact/v2/user/userid认证方式: access_token,请参考获取access_token请求头部:Accept-Charset:UTF-8 Content-Type:application/json x-wlk-Authorization:access_token请求参数说明:  参数名参数说明类型必选deptCode部门编码。从用户详细信息中获取部门编码string是pageNo当前页数。默认为1string否pageSize每页显示数量。默认为10(不能大于50)string否请求示例:curl -X GET "https://open.welink.huaweicloud.com/api/contact/v2/user/userid?deptCode=3003" -H "Accept-Charset: utf-8" -H "x-wlk-Authorization: access_token"响应格式说明正常返回结果  {    "code": "0",    "message": "OK",    "pageNo": 1,    "pages": 1,    "pageSize": "10",    "total": 2,    "data": [{            "userId": "test5365",            "corpUserId": "test5365@huawei.com",            "userNameCn": "测试5365",            "userNameEn": "test5365"         },         {            "userId": "test5363",            "corpUserId": "test5363@huawei.com",            "userNameCn": "测试5363",            "userNameEn": "test5363"         }     ] }异常返回结果  {    "code": "47101",    "message": "Token格式错误",    "data": []   }返回参数说明:参数名必选类型参数说明code是string数据正常返回“0”,如果发生错误,会返回对应的错误码message是string返回信息,包括接口请求发生错误时的详细信息pageNo是int当前页数pages是int总共页数pageSize是string每页显示用户信息数量total是int总数量data否array用户简单信息:>> userId: 用户账号>> corpUserId: 该用户在租户自身系统的登录标识,用于认证和邮箱登录(客户内唯一)>> userNameCn: 用户中文名称>> userNameEn: 用户英文名称错误码说明:错误码说明47000无权限47001当前登录用户信息获取失败47002部门编码为空47003参数为空47004参数不对47007当前登录者是非法用户或个人详情已失效47008参数校验不通过47009提交失败47012无数据47013查询数量限制47100待处理47101Token格式错误47102无权限47103Token过期47104处理中47105秘书账号未创建47106上级部门未创建500系统错误
  • [WeLink&开放平...] WeLink开放平台企业内部应用服务端API--通讯录--查询用户userId
    通过员工工号corpuserId获取用户的唯一标识,该接口依赖开户时需要设定员工的企业工号,否则WeLink系统中该字段为空,无法查询userId。请求格式说明请求方式: POST(HTTPS)请求地址: https://open.welink.huaweicloud.com/api/contact/v1/users/accounts认证方式: access_token,请参考获取access_token请求头部:x-wlk-Authorization: access_token Content-Type: application/json请求参数:  {  "corpUserId": ["zhangsan", "lisi"] }请求参数说明:参数参数类型必填说明corpUserIdList是corpUserId列表(多个id用“,”分隔,最多支持50个一次)请求示例:curl -X POST \   https://open.welink.huaweicloud.com/api/contact/v1/users/accounts \   -H 'Content-Type: application/json' \   -H 'x-wlk-Authorization: access_token' \   -d '{        "corpUserId": ["zhangsan", "lisi"]       }'响应格式说明返回结果:  {  "code":"0",    "message":"OK",    "userInfo":[         {            "userId":"zhangsan@welink",              "corpUserId":"zhangsan"          },         {            "userId":"lisi@welink",            "corpUserId":"lisi"         }     ] }返回参数说明:参数说明code数据正常返回“0”,如果发生错误,会返回对应的错误码。message返回信息,包括接口请求发生错误时的详细信息。userInfo用户信息userId用户帐号corpUserId第三方集成帐号(员工工号)错误码说明:错误码说明47001当前登录用户信息获取失败47003参数为空47012无数据47013查询数量限制500系统错误
  • [WeLink&开放平...] WeLink开放平台企业内部应用服务端API--通讯录--查询用户父级部门
    根据用户信息(userId、corpUserId、mobileNumber)获取用户所在部门的所有上级父部门信息。请求格式说明请求方式: GET (HTTPS)请求地址: https://open.welink.huaweicloud.com/api/contact/v1/user/parent认证方式: access_token,请参考获取access_token请求头部:Accept-Charset:UTF-8 Content-Type:application/json x-wlk-Authorization:access_token请求参数说明:  参数名参数说明类型必选userId用户账号string特殊可选(userId,corpUserId和mobileNumber不能同时为空)corpUserId该用户在租户自身系统的登录标识,用于认证和邮箱登录(客户内唯一)string特殊可选(userId,corpUserId和mobileNumber不能同时为空)mobileNumber绑定手机号码string特殊可选(userId,corpUserId和mobileNumber不能同时为空)请求示例:curl -X GET "https://open.welink.huaweicloud.com/api/contact/v1/user/parent?userId=test123@huawei.com" -H "Accept-Charset: utf-8" -H "x-wlk-Authorization: access_token"响应格式说明正常返回结果  {    "code": "0",    "message": "OK",    "data": [       {        "deptAllCode": "1008>>2006>>3006",        "deptAllNameCn": "一级部门>>二级部门>>测试本部门",        "deptAllNameEn": "1stDeptName>>2ndDeptName>>TestDeptName"       }     ]   }异常返回结果  {    "code": "47101",    "message": "Token格式错误",    "data": []   }返回参数说明:参数名必选类型参数说明code是string数据正常返回“0”,如果发生错误,会返回对应的错误码message是string返回信息,包括接口请求发生错误时的详细信息data否array部门路径信息:>> deptAllCode: 部门路径编码>> deptAllNameCn: 部门路径中文名称>> deptAllNameEn: 部门路径英文名称错误码说明:错误码说明47000无权限47001当前登录用户信息获取失败47002部门编码为空47003参数为空47004参数不对47007当前登录者是非法用户或个人详情已失效47008参数校验不通过47009提交失败47012无数据47013查询数量限制47100待处理47101Token格式错误47102无权限47103Token过期47104处理中47105秘书账号未创建47106上级部门未创建500系统错误
  • [WeLink&开放平...] WeLink开放平台企业内部应用服务端API--通讯录--查询用户详情
    请求用户详细信息的接口,使用用户userId获取用户详细数据。请求格式说明请求方式: GET (HTTPS)请求地址: https://open.welink.huaweicloud.com/api/contact/v1/users认证方式: access_token,请参考获取access_token请求头部:x-wlk-Authorization: access_token请求参数:  参数说明userId用户帐号mobileNumber绑定的手机号码corpUserId该用户在租户自身系统的登录标识,用于认证和邮箱登录(客户内唯一)可通过三个请求参数任意一个获取。请求示例:  curl  -H "x-wlk-Authorization: access_token" https://open.welink.huaweicloud.com/api/contact/v1/users?userId=zhangshan2@cloudlink响应格式说明返回结果:  {  "code": "0",  "message": "ok",  "userStatus": "1",     "userId": "zhangshan2@welink",  "deptCode": "10001",  "mobileNumber": "+86-15811847236",  "userNameCn": "张三",  "userNameEn": "zhangshan",  "sex": "M",  "corpUserId": "36188",  "userEmail": "zhangshan4@126.com",  "secretary": "zhangshan@welink",  "phoneNumber": "0755-88888888",  "address": "广东省深圳",  "remark": "欢迎加入WeLink",  "isActivated": 1,  "creationTime": "2018-05-03 13:58:02",  "lastUpdatedTime": "2018-05-03 13:58:02"}返回参数说明:参数说明code数据正常返回“0”,如果发生错误,会返回对应的错误码。message返回信息,包括接口请求发生错误时的详细信息。userStatus状态, 1:未开户2:开户中3:已开户4已销户userId用户帐号, Key值, 必填deptCode部门Id, Key值, 必填mobileNumber绑定手机号码, 必填userNameCn用户中文名称, 必填userNameEn用户英文名称, 必填sex性别, 仅:M/F,  M: 男, F: 女, 必填corpUserId该用户在租户自身系统的登录标识,用于认证和邮箱登录(客户内唯一)(集成用的字段,如果在开户时没有维护则为空), 字段可以为中文且区分大小写userEmail用户邮箱, 必填secretary秘书(用户帐号)phoneNumber电话号码(座机)address地址remark备注isActivated用户是否已激活(用户登陆WeLink客户端表示已激活), 1为已激活,0为未激活creationTime创建时间lastUpdatedTime最后更新时间错误码说明:错误码说明47001当前登录用户信息获取失败47003参数为空47004仅支持一个参数47005参数输入错误,请按指定值输入500系统错误
  • [WeLink&开放平...] WeLink开放平台企业内部应用服务端API--通讯录--通过免登授权码查询用户userId
    通过免登授权码code获取用户唯一标识userId请求格式说明请求方式: GET (HTTPS)请求地址: https://open.welink.huaweicloud.com/api/auth/v2/userid认证方式: access_token,请参考获取access_token获取此接口的access_token时,参数不需要传tenantId请求头部:x-wlk-Authorization: access_token请求参数说明:  参数名参数说明类型必选code免登授权码,获取方式参考We码小程序免登授权码或者H5轻应用免登授权码string是请求示例:  curl  -H "x-wlk-Authorization: access_token" https://open.welink.huaweicloud.com/api/auth/v2/userid?code=xxx响应格式说明返回结果:  {    "code":"0",    "message":"ok",    "userId": "zhangsan@welink",    "tenantId": "AXSCC123ND2DESC..." }返回参数说明:参数说明code数据正常返回“0”,如果发生错误,会返回对应的错误码message返回信息,包括接口请求发生错误时的详细信息userId用户帐号tenantId租户id错误码说明:错误码说明41500获取用户信息异常。
  • [教程] CBS对话机器人服务API调用常见问题FAQ
    #### Q: 如何调用机器人对话API? **A:** [API调用文档](https://support.huaweicloud.com/api-cbs/cbs_03_0012.html)。---- #### Q: 多轮问答的API分开启会话、处理会话、关闭会话,API之间有什么关系,其中处理会话和关闭会话的session_id是什么? **A:** 多轮问答不同于单轮问答,其接口涉及***session会话***的概念。由于单轮问答即[问答请求](https://support.huaweicloud.com/api-cbs/cbs_03_0072.html)情况下,机器人只需回答当前问题;而在多轮问答情况下,机器人需参考前序交互给出回答,因此用户在对接[多轮问答](https://support.huaweicloud.com/api-cbs/cbs_03_0112.html)时需首先调用开启会话接口获得一个***session_id***,以***session_id***为基础调用处理会话API,并在会话结束后调用关闭会话API,会话关闭后该***session_id***不可重用,需再次调用开启会话获取一个新的***session_id***。---- #### Q: 为什么按照文档调用,接口响应为 `{"error_msg":"The API does not exist or has not been published"}` **A:** [认证鉴权](https://support.huaweicloud.com/api-cbs/cbs_03_0006.html)调用`/v3/auth/tokens`接口**获取鉴权token**,该接口由***IAM服务***提供,因此需使用***IAM endpoint***进行调用,如**北京四地址**为`iam.cn-north-4.myhuaweicloud.com`。调用**机器人相关接口**时,需使用***CBS endpoint***进行调用,如**北京四地址**为`cbs-ext.cn-north-4.myhuaweicloud.com`。如使用了***错误的endpoint***,则会出现问题中的情况。详细列表请查看[地区和终端节点](https://developer.huaweicloud.com/endpoint)。---- #### Q: 为什么我使用Postman进行调用,显示`Could not get any response. There was an error connecting to *****`? **A:** 使用**Postman**无法正常连接通常为运行环境网络问题,可参考如下检查: - 复制完整URL到浏览器地址栏,页面是否显示`{"error_msg":"****","error_code":"APIGW.xxxx"}`,如无法显示,则可能运行环境网络异常 ![image.png](https://bbs-img-cbc-cn.obs.cn-north-1.myhuaweicloud.com/data/attachment/forum/202004/15/155957wyiviryhioycc2hw.png) - 检查运行环境是否涉及代理配置,***Setting -> Proxy***可对Postman进行代理设置,如何设置代理请自行询问运行环境管理员。---- #### Q: 为什么我已正确获取token,并使用CBS服务endpoint进行API调用,得到的响应是`{"error_msg":"auth failed"}`? **A:** `auth failed`为鉴权失败,通常由以下原因引起: - ***token*过期**,调用`/v3/auth/tokens`接口获取token时,在对应的响应体中可以看到`expires_at`字段,超过该时段后token将失效,需重新获取 - **获取*token*时未指定*project*参数**,请对照[认证鉴权](https://support.huaweicloud.com/api-cbs/cbs_03_0006.html)给定的参数格式,必须使用指定了***scope->project->name***方式获取的token,才能正常对接**CBS服务**。 - ***token和projectId不匹配***,请确认`/v3/auth/tokens`响应中的***projectId***与调用***CBS服务API***时指定的***projectId***是否一致,可对应[获取项目ID](https://support.huaweicloud.com/api-cbs/cbs_03_0069.html)进行检查。 ![image.png](https://bbs-img-cbc-cn.obs.cn-north-1.myhuaweicloud.com/data/attachment/forum/202004/15/1513582xcmzim5om31ger3.png) - ***token和endpoint不匹配***,如获取token时指定的***project***为***cn-north-4***,而在API调用时使用***cbs-ext.cn-north-1.myhuaweicloud.com***进行对接,也无法通过鉴权认证,需使用对应的***projectId***和***endpoint***---- #### Q: 为什么我调用对话API,响应为机器人不存在,可在对话机器人界面可以正常进行对话体验啊? **A:** 对话API包含问答机器人和话务机器人两类,其中调用**问答机器人API需使用问答机器人ID**,**话务机器人API需话务机器人ID**,不同的机器人ID在API调用时不通用,请核对检查选择正确的API类型。
  • [WeLink&开放平...] WeLink开放平台第三方企业应用服务端API开发前必读
    开发前准备开发文档阅读说明请求格式说明:请求方式 : GET/POST                   请求地址 :https://open.welink.huaweicloud.com/xxx 认证方式 :access_token                           请求头部: ...... 请求参数: ...... 请求示例: ......响应格式说明:返回参数: ...... 返回参数说明: ...... 错误码说明: ......1、请求格式说明:描述接口的请求方式,地址,参数以及示例等内容。2、响应格式说明:描述接口的返回参数,参数说明,错误码说明。userId与tenantId的机制WeLink尊重租户的数据,采取了租户数据完全隔离的设计。userId在各个租户都是独立的。相同的人在不同的租户,具备不同的userId。不同的租户通过tenantId区分因此采取userId获取用户数据时,可以对应到租户内唯一的用户。关于频率限制出于对系统稳定运行的考虑,我们对接口的调用做了频率限制。参见接口调用频率限制关于返回字段WeLink对接口的返回字段做了简化处理,对于每个字段,如果接口的值为空或者null的话,接口里将不返回。服务端接口权限申请概述为避免保证数据安全,WeLink的接口被调用时,会校验access_token对应的应用是否已经申请了该接口的调用权限。如果没有申请该接口的调用权限时,将返回501错误,并提示“第三方接口无权限”应用在 开发者后台->应用开发->接口权限 中申请必要的权限,租户在订阅(购买)企业第三方应用时,对权限清单进行授权,同时市场的管理员也会审视应用权限是否超出应用本身的特性范围,不允许过度获取用户数据用做他用。服务端接口权限与API对应清单权限名称权限描述对应API接口用户登录信息获取用户的基本信息,用于登录系统和应用/auth/v2/userid/contact/v1/users/accounts//weopen/v1/isadmin/轻应用鉴权轻应用鉴权,用于调用JS-API/auth/v1/jstickets租户详细信息获取租户详细信息,如租户名称、许可等/tenant/v1/tenants用户基本信息获取用户信息,不包含手机号、邮箱等敏感信息/contact/v1/users/simple用户邮箱信息获取用户信息,包括邮箱等/contact/v1/users/email组织架构信息按userid或部门id,以部门编码方式获取组织架构/contact/v2/departments/list/contact/v1/department/parent/contact/v1/user/parent/contact/v1/departments/{deptcode}部门人员信息根据部门编码查询部门人员信息/contact/v2/user/users公众号消息通过公众号推送通知消息/messages/v3/send/messages/v1/send [废弃]待办通知将待办事项推送到WeLink/todo/v1/addtask/todo/v1/updatetask/todo/v1/deltask企业变更事件租户信息变化时通知到企业第三方应用参考业务事件回调通讯录变更事件部门变更、部门删除、人员变更、人员销户通知到企业第三方应用参考业务事件回调注意事项用户邮箱信息, 组织架构信息, 通讯录变更事件, 部门人员信息均为敏感权限,如果没有必要,请务必不要申请。安全审核团队将会对这些权限严格审批。目前开发者后台的权限未做分离,有些权限只允许企业内部应用使用。第三方应用申请的权限只允许在此文档中有的,禁止申请此文档中不包含的权限,否则上架审批将驳回。企业变更事件和通讯录变更事件是WeLink调用第三方应用的后台,将企业内数据变动推送到第三方应用(如无必要请不要申请),具体实现参考业务事件回调            开发前准备                                         获取access_token                                         接口权限申请                                         接口权限申请                                         接口频率限制                                         应用授权                                         获取企业凭证(access_token)                                         获取企业详细信息                                         接入步骤                                         概述                                         接口回调                                         接入指引                                         体验版应用订阅通知                                         正式应用订阅通知                                         接口调用                                         身份验证                                         概述                                         接入步骤                                         错误码                                         概述                                         企业内部We码小程序免登                                         企业内部H5轻应用免登                                         应用管理后台免登                                         身份验证                                         概述                                         接入步骤                                         错误码                                         概述                                         第三方企业We码小程序免登                                         第三方企业H5轻应用免登                                         应用管理后台免登                                         通讯录                                         查询部门详情                                         查询父部门信息                                         查询子部门信息                                         异步批量同步部门                                         查询部门异步同步结果                                         通过免登授权码查询用户userId                                         查询用户详情                                         查询用户父级部门                                         查询用户userId                                         查询部门的人员信息列表(简单信息)                                         查询部门的人员信息列表(详细信息)                                         异步批量同步用户                                         查询用户异步同步结果                                         概述                                         用户管理                                         部门管理                                         通讯录                                         获取部门详情                                         查询父部门信息                                         查询子部门信息                                         通过免登授权码查询用户userId                                         查询用户userId                                         查询用户基本信息                                         查询用户邮箱信息                                         查询用户父级部门                                         查询部门人员信息                                         概述                                         用户管理                                         部门管理                                         消息通知                                         公众号消息接口                                         公众号消息说明                                         考勤打卡                                         待办接入                                         概述                                         新增待办任务                                         更新待办任务                                         删除待办任务                                         待办接入                                         概述                                         签名算法介绍                                         AppList接口                                         TaskList接口                                         服务注册指导                                         调试与验证                                         新增待办任务                                         更新待办任务                                         删除待办任务                                         数据落地方式                                         数据不落地方式                                         业务事件回调                                         概述                                         接口回调及事件列表                                         知识管理                                         新增文章                                         修改文章                                         删除文章                                         文章管理                                         会议                                         预约会议                                         取消预定会议                                         修改预定会议                                         查询会议列表                                         查询会议信息                                         查询历史会议列表                                         查询历史会议信息                                         错误码参考                             接口频率限制为了防止企业和ISV应用的程序错误而引发WeLink服务器负载异常,默认情况下,每个服务端调用接口都有一定的频率限制,当超过此限制时,调用对应接口会收到相应错误码。以下是当前默认的频率限制,WeLink后台可能会根据运营情况调整此阈值:(1)每个接口每秒能被调用的次数都有一个上限,触发上限的话接口会返回错误码48503。遇到此错误码,需要你在服务端代码里等待一段时间再继续运行。(2)企业和ISV的每个IP,调用所有开放平台接口总量,不能超过20秒3000次,否则返回错误码48503,需要开发者自行处理。处理方法为:增加IP的数量,控制调用量。(3)每个client_id调用单个接口的频率不可超过40次/秒或者1500次/分,否则返回错误码48503。
  • [WeLink&开放平...] 创建We码小程序指南
    创建We码小程序1、使用WeLink账号登录开放平台,账号由租户管理员统一开通;2、在开放平台点击“创建应用”,按页面提示填写相应信息;3、创建应用字段说明字段说明应用图标需要按照规范上传图标作为应用图标,应用图标在应用上线后展示在移动端应用中心中文名称应用中文名称英文名称应用英文名称中文介绍可选,如果有必要可以介绍应用的具体功能和使用场景,方便用户使用英文介绍可选,如果有必要可以介绍应用的具体功能和使用场景,方便用户使用开发团队信息可以填写应用主体,如应用出现问题或者有用户反馈可以联系到开发者服务及数据来源非必须,可以填写应用的网站信息,介绍该服务的特性和功能,此处的数据来源非We码小程序的服务接口或者后端服务应用基础信息和权限1、在开发We码小程序,开发者调用服务端接口,需要或者应用client_id 和 client_secret ,见下图:配置回调地址(可选)1、WeLink业务数据发生变更时,将通过回调地址告诉We码小程序服务,We码小程序根据自己的需要提供回调地址,回调服务开发请参考服务端API文档相关说明。2、测试Callback Url可用性配置应用后台UrlWe码小程序如果有后台可以配置一个后台页面地址,租户管理员可以在业务中心,点击进入管理后台进行管理操作。后台页面地址建议集成免登录,请参考服务端API文档相关说明。接口权限配置We码后端服务集成服务端API,例如免登、通讯录查询,开发者需要点击接口权限,确保使用到的API权限处于开通的状态。权限与接口的对应关系请参考服务端文档说明。提示:调试过程中如发现错误码接口返回501,请点击申请权限,同时重新获取token后再试。We码小程序免登WeLink内部免登第三方网站用户在进入您开发的应用时,无需用户输入用户名密码,应用即可获取用户身份的流程。具体可参考免登录文档说明。
  • [技术干货] 园区第三方认证类API概述及向导
    快速开始接口概述第三方认证主要应用于商业Wi-Fi终端用户在商场、大型综超、酒店、机场等场所通过Wi-Fi访问互联网的场景。第三方合作伙伴为终端用户提供认证Portal页面,并调用第三方认证API或通过标准RADIUS协议对用户授权,使能终端用户接入网络。从而实现认证、计费等基础服务,以及用户分析、市场营销等增值服务。在第三方认证中只有云平台中继认证才会需要进行二次开发,当前支持的云平台中继认证有如下两种:方式1:云平台中继认证(API方式)方式2:云平台中继认证(RADIUS方式)方式1:云平台中继认证(API方式)终端用户在访问互联网时,连接Wi-Fi的SSID,登录由第三方系统推送的Portal页面进行认证。第三方系统调用华为iMaster NCE-Campus平台认证授权API,给AP设备授权终端Wi-Fi接入权限,从而使终端用户访问互联网。iMaster NCE-Campus与第三方系统通过API方式交互第三方认证系统,可以根据客户需求进行Portal页面定制、广告推送等应用。主要包含如下两大子系统:Portal Server:用于提供Portal 认证功能。授权平台:用于调用iMaster NCE-Campus的API接口,实现对终端的控制能力(如授权、授权结果查询、强制用户下线等)。登录认证客户端向服务器下发登录认证请求,服务器返回一个Token和过期时间。此处为模拟调测环境,已经为各位开发者创建好北向用户帐号。在调用真实环境的北向接口之前,应在iMaster NCE-Campus上创建具有Open Api Operator角色的帐号,用于获取Token。操作详情请参见创建北向用户。请求URL获取Token值使用如下URL:https://devzone.huawei.com/cloudcampusdb/controller/v2/tokensHeaders此API使用如下Headers参数进行登录认证:Headers参数值Content-Typeapplication/jsonAcceptapplication/jsonAccept-Languageen-US请求示例请求参数userName 和password为您的华为云帐号和密码。curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Accept-Language: en-US' -d '{"userName":"huaweiUser","password":"huaweiPassword"}' 'https://devzone.huawei.com/cloudcampusdb/controller/v2/tokens'登录认证成功响应{    "errcode": "0",    "errmsg": "get token successfully.",    "data": {        "expiredDate": "2020-01-08T17:10:11,887+08:00",        "token_id": "aHVhd2VpcGFvZnU6SHVhd2VpMTIjJA=="    }}下发RESTful请求客户端携带上面的Token再下发RESTful请求给服务器。请求URL调用查询用户组API使用如下URL:https://devzone.huawei.com/cloudcampusdb/controller/campus/v1/accountservice/usergroupsHeaders此API使用如下Headers参数下发RESTful请求:Headers参数值Content-Typeapplication/jsonAcceptapplication/jsonAccept-Languageen-USX-ACCESS-TOKEN{token_id}请求示例X-ACCESS-TOKEN取值为已获取的Token值token_id。curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Accept-Language: en-US' --header 'X-ACCESS-TOKEN: aHVhd2VpcGFvZnU6SHVhd2VpMTIjJA==' -d '{"parentId":" a91e1696-02a2-4a68-bad4-aa639359c8cf","name":"friendName","address":"Xihu North Community","postalCode":"125744","adminEmail":"admin%40huawei.com","description":"common user group"}' 'https://devzone.huawei.com/cloudcampusdb/controller/campus/v1/accountservice/usergroups'响应{     "data": {          "address": "Xihu North Community",          "adminEmail": "admin%40huawei.com",          "bsid": "",          "description": "common user group",          "fullPathName": "",          "id": "3e7d7186-dff6-48cf-8254-61cceae00090",          "name": "friendName",          "orderId": 0,          "parentId": "a91e1696-02a2-4a68-bad4-aa639359c8cf",          "postalCode": "125744"     },     "errcode": "0",     "errmsg": ""}向导创建北向用户使用华为云帐号登录沙箱预约系统。请参考预约实验室使用指导,完成实验室预约。进入“我的环境 > 物理实验室”,当实验室为 active 状态时,单击已预约实验室操作列表的“体验”,进入体验界面。单击iMaster NCE-Campus图标,在“属性”页签获取iMaster NCE-Campus 的IP、用户名和密码(使用此用户名和密码登录iMaster NCE-Campus,用于创建北向用户)。鼠标悬浮至iMaster NCE-Campus图标,单击,可使用上面获取的用户名和密码登录到iMaster NCE-Campus。选择“系统 > 系统管理 > 管理员”,在“用户”页签中单击“创建”,创建Open Api Operator帐号。请将“首次登录修改密码”选择“否”。两次单击“下一步”。单击“确定”。REST API约束与注意接口的输入参数、请求消息体、结果消息体统一采用UTF-8编码。通过PUT进行修改操作时,如果非必填字段在报文中未携带,或填为null,则此字段维持原值,不作修改。若想清空一个string字段,可以填入空字符串””。HTTP Header中,可以通过Accept-Language设置en-US来指定返回信息为英文,若不指定Accept-Language,则默认返回英文信息。通过API创建的数据,不能在iMaster NCE-Campus界面上删除。所有API的请求报文中Host端口号由18008改为18002。所有API的接口使用的是北向IP。API接口调用会话超时时间默认设置为10分钟,若10分钟内无会话交互,则系统会自动清理会话session。接口规范iMaster NCE-Campus的所有REST接口的URL地址均遵从下述规范:<OP> / <service-path> / <resource> ? <query>OP:对应方法,方法包括POST、PUT、DELETE、GET。service-path:REST API微服务路径。resource:操作的资源路径。query:参数集。使用“name=value”对标识。HTTP HeadersiMaster NCE-Campus对REST接口的Headers进行了一定的限制,主要包括如下几个参数:Content-Type:包含了文档的“mime-type”。浏览器将会依据该参数决定如何对文档进行解析。Accept:表示浏览器可接受的MIME类型。浏览器将会依据该参数决定接受何种参数格式。Accept-Language:服务器端可接受的语言类型默认为en-US。X-ACCESS-TOKEN:发送Token信息给服务器。方法说明方法URI格式功能说明幂等性GET<serivce-path>/<identifier>1、获取数据并且返回状态。2、<identifier>指向要检索的数据节点。是PUT<serivce-path>/<identifier>1、更新数据并且返回状态。2、<identifier>指向要存储的数据节点。是POST<serivce-path>/<identifier>1、创建一个节点并返回状态。2、<identifier>指向要被存储的数据节点。否DELETE<serivce-path>/<identifier>1、删除一条数据且返回状态。2、<identifier>指向要被删除的数据。否状态码定义RESTful采用HTTP状态码来报告操作结果。状态码描述2xx操作成功400操作失败,错误的详细描述在errmsg中体现401未授权,常见错误为token填错、或已超时403不允许访问,常见错误为该管理员无对应权限或访问的资源不存在404请求的资源不存在,常见错误为,尝试GET不存在的资源415不支持请求中的报文体格式,常见错误为,未填Content-Type,或Content-Type的值不为application/json500服务器内部错误,常见错误为请求header中缺少必填字段503服务不可用,常见错误为ddos攻击Java SDK向导准备工作如果您还没有下载Java SDK,请先点击这里CloudCampus Java SDK JAR下载我们的SDK JAR文件,SDK源码请参考CloudCampus Java SDK Sources。注:推荐使用JDK1.8及以上版本。导入SDK包将您下载的SDK JAR包导入您的Java工程,如果您使用maven构建您的工程,使用此命令将SDK安装到您的maven本地仓:mvn org.apache.maven.plugins:maven-install-plugin:3.0.0-M1:install-file -Dfile=cloudcampus-1.0.0.jar随后在您的maven工程的pom.xml文件中引入SDK依赖:<dependency>    <groupId>com.huawei.cloudcampus.api</groupId>    <artifactId>cloudcampus</artifactId>    <version>1.0.0</version>  </dependency>初始化客户端使用com.huawei.cloudcampus.api.ApiClient类来初始化您的SDK,您需要配置北向API使用的端口号(18002),iMaster NCE-Campus控制器的IP以及北向帐号和密码(请参考创建北向用户),如下所示:ApiClient apiClient = new ApiClient(); apiClient.setTenantName("tenant@north.com"); apiClient.setTenantPwd("Admin@1234"); apiClient.setHost("139.9.213.72"); apiClient.setPort("18002");SDK使用示例根据授权回话ID,查询授权结果:ClientUserManagerApi api = new ClientUserManagerApi(apiClient);Gson gson = new Gson();String psessionid = "5ea660be98a84618fa3d6d03f65f47ab578ba3b4216790186a932f9e8c8c880d";String nodeIp = "192.168.211.236";CommonAuthorizationOutputDto response = api.getAuthorizationresult(psessionid, nodeIp);String result = gson.toJson(response);System.out.println(result);Python SDK向导准备工作如果您还没有下载Python SDK,请先点击这里CloudCampus Python SDK Sources下载我们的Python SDK源码文件。安装SDK下载完成后,解压文件。打开cmd命令行,运行如下命令进入CloudCampus Python SDK源码文件夹,例如运行如下命令:cd FilesPathFilesPath为CloudCampus Python SDK源码文件夹运行如下命令安装Python SDK:pip install -r requirements.txtpython setup.py install安装完成后,运行如下命令查看SDK是否安装成功:pip list导入SDK包以查询授权结果接口为例:导入ApiClient、Configuration,和本次调用的api(ClientUserManagerApi)from swagger_client.api_client import ApiClientfrom swagger_client.apis.client_user_manager_api import ClientUserManagerApifrom swagger_client.configuration import Configuration初始化客户端使用ApiClient类来初始化您的SDK,您需要配置北向API使用的端口号(18002),iMaster NCE-Campus控制器的IP以及北向帐号和密码(请参考创建北向用户),如下所示:tenantName = 'tenant@north.com'tenantPwd = 'Admin@1234'host = '139.9.213.72'port = '18002'config = Configuration(host, port, tenantName, tenantPwd)api_client = ApiClient(config)SDK使用示例根据授权回话ID,查询授权结果:api = ClientUserManagerApi(api_client)psessionid = '5ea660be98a84618fa3d6d03f65f47ab578ba3b4216790186a932f9e8c8c880d'nodeIp = '192.168.211.236'model = api.get_authorizationresult(psessionid=psessionid, node_ip=nodeIp)方式2:云平台中继认证(RADIUS方式)认证流程终端用户在访问互联网时,连接Wi-Fi的SSID,登录由第三方系统推送的Portal页面进行认证。第三方系统与华为iMaster NCE-Campus云平台通过标准RADIUS协议对接,实现Portal认证和计费等功能。iMaster NCE-Campus与第三方系统交互流程支持的RADIUS消息iMaster NCE-Campus作为中继角色,可以将RADIUS消息发送给第三方的RADIUS服务器,实现认证、授权和计费功能。支持的RADIUS消息字段如下所示:认证消息列表消息列表说明User-Name用户名,设置时候可以带域名(如user0001@isp),也可以不带域名(如user0001)。内容可以是用户MAC或配置的用户名。User-Password用户密码,PAP认证时,用户密码由NAS加密后传递给服务器。系统支持的用户PAP认证密码长度为0~128。内容可以是MAC地址或配置的密码。Called-Station-ID用来携带NAS设备的号码信息,一般为设备MAC地址(有线用户)或SSID(WLAN无线用户)。Calling-Station-ID用来携带客户端的号码信息,一般为MAC地址。Acct-Session-ID计费ID。格式:7位主机名+2位槽号+1位子卡号+2位端口号+ 4位外层VLAN+5位内层VLAN+6位CPU Tick+6位用户连接ID。Framed-IP-Address用户的IP地址。NAS-Port-ID用户接入的槽位号、子槽位号、端口号及vlanid。格式有两种:1. 老格式:2位槽号+2位子卡号+3位端口号+9位VLAN。2. 新格式:slot=槽号;subslot=子卡号;port=端口;vlanid=VLAN或者slot=槽号;subslot=子卡号;port=端口;vlanid=外层VLAN ;vlanid2=内层VLAN。NAS-Port-Type设置NAS的端口类型,用户在交换机接口下可以配置。默认类型是Ethernet(15),无线用户为IEEE_802.11(19)。Service-Type提供的服务类型。2(Framed):PPP、802.1x用户等其他用户。5(Outbound):IPSession接入用户。6(Administrative):管理用户。10(Call Check):MAX认证用户。授权消息列表消息列表说明Session-Timeout在Access-Accept报文中,表示用户剩余的时间,以秒为单位。在CHALLENGE报文中作为EAP用户的重认证时长。下发数值必须大于0。可利用该属性下发用户在线时长。Idle-Timeout用户的闲置切断时间, 以秒为单位。HW-Input-Committed-Information-Rate上行承诺速率,单位bps(上行CIR)。HW-Output-Committed-Information-Rate下行承诺速率,单位bps(下行CIR)。Reply-Message此属性可用于认证接受报文中,表示成功消息, 也可用于认证拒绝报文中, 表示拒绝消息. 目前只对WEB认证用户,会把此信息传给用户。对于WEB认证,必须WEB服务器的版本支持。Filter-ID通常该属性携带用户ACL号或用户组名或ucl-group名。RADIUS报文中只能携带ACL号或用户组名,不能同时携带两者。计费消息列表消息列表说明Acct-Delay-Time用于上报发送该计费包花费的时间, 以秒为单位(不包括网络传输时间)。计费服务器收到该计费请求包后, 可以从该计费请求包到达计费服务器的时间减去Acct-Delay-Time表示的时间得到NAS生成该计费请求包的时间(报文创建的时间)。在交换机中, Acct-Delay-Time表示的时间由两部分构成,一部分是RADIUS模块到AAA来取数据的时间和最近一次刷新的时间差,另外一部分是RADIUS模块发送该计费请求包耽误的时间(比如重传花费的时间)。Acct-Session-ID计费ID。格式:7位主机名+2位槽号+1位子卡号+2位端口号+ 4位外层VLAN+5位内层VLAN+6位CPU Tick+6位用户连接ID。Acct-Status-Type计费请求报文的类型. Accounting-Request中支持的计费请求报文类型如下:Start (Value=1)Stop (Value=2)Interium-Update (Value=3)Calling-Station-ID用来携带客户端的号码信息,一般为MAC地址。Event-Timestamp生成计费请求报文的时间 (以秒为单位, 表示从1970年1月1日零点零分零秒以来的绝对秒数)。Framed-IP-Address用户的IP地址。NAS-IdentifierNAS设备名称,即sysname,主机名。NAS-IP-Address标识设备地址:可以配置绑定具体的接口,取接口地址作为NAS-IP。如果没有配置,取报文发送的出接口地址为NAS-IP。NAS-Port用户接入的物理端口信息,格式有两种:1. 12位槽号+8位端口号+12位VLAN,位数不足用0补齐。2. 8位槽号+4位子卡号+8位端口号+12位VLAN,位数不足用0补齐。3. 可通过命令行radius-server format-attribute nas-port format-sting配置自定义属性携带的内容,参数format-string定义内容可以为槽号、子槽号、端口、外层VLAN、内层VLAN内容的任意组合,内容之间可以用1或0填充。format-sting参数详细说明如下:1. 使用关键字s、t、p、o、i分别表示slot,subslot,port,out-vlan(qinqvlan)/vpi,vlan(user-vlan)/vci。增加两个关键字n、z以便填充用。n表示填1,z表示填0。2. s、t、p、o、i、z、n关键字后面必须是数值,并且数值范围为1~32。且s、t、p、o、i中的每个关键字只能出现一次。3. s、t、p、o、i、z、n后面若是紧跟数字则第一个数字只能是1~9不能是0。4. n、z可以出现在任何位置并且可出现多次,n、z后面跟数字,n12表示该位置填12位1,z12表示该位置填充12位0。5. 字段串配置的位数加起来必须为32位。6. 必须以s、t、p、o、i、z、n开头,以数字结尾。7. VLAN不存在时填0还是填1可以在o或i关键字前添加n、z说明,也就是说n、z后面可以跟数字或o/i。Acct-Session-Time用户的在线时长, 以秒为单位。Acct-Input-Packets上行流量,单位报文个数。Acct-Output-Packets下行流量,单位报文个数。Acct-Input-Octets上行流量,单位字节数。Acct-Output-Octets下行流量,单位字节数。Acct-Input-Gigawords上行流量,单位1G字节数。
  • [问题求助] 部署案例失败,提示找不到-ldvpp api
    并且,通过同步的方式获取了lib的库,不知道是不是交叉编译的问题,希望可以能够得到帮助,谢谢
  • [问题求助] 求基于C#语言的eSDK API Demo
    ISV的系统是C#语言开发的,基于API方式与vcn对接。我们现在能下载到的API方式接口开发资料都是基于C++的,想问下有没有基于C#语言的eSDK API Demo可提供参考?
总条数:1108 到第
上滑加载中