概述

华为企业园区构建智能、极简的园区网络,支持办公/商超/教室/酒店等多场景,提供高品质网络。支持快速集成第三方AAA系统、管理系统、增值应用等。基于大数据的安全策略自动化保障网络安全可靠。

应用场景

API通用介绍

  • 接口的输入参数、请求消息体、结果消息体统一采用UTF-8编码。
  • 通过PUT进行修改操作时,如果非必填字段在报文中未携带,或填为null,则此字段维持原值,不作修改。若想清空一个string字段,可以填入空字符串""。
  • HTTP Header中,可以通过Accept-Language设置en-US来指定返回信息为英文,若不指定Accept-Language,则默认返回英文信息。
  • API接口调用会话超时时间默认设置为10分钟,若10分钟内无会话交互,则系统会自动清理会话session。

iMaster NCE-Campus对REST接口的Headers进行了一定的限制,主要包括如下几个参数:

  • Content-Type:包含了文档的“mime-type”。浏览器将会依据该参数决定如何对文档进行解析。
  • Accept:标识浏览器可接受的MIME类型。浏览器将会依据该参数决定接受何种参数格式。
  • Accept-Language:服务器端可接受的语言类型:en-US。如果不指定,则默认语言类型为en-US。
  • X-AUTH-TOKEN:发送Token信息给服务端,兼容X-ACCESS-TOKEN方式。
方法 URI格式 功能说明 幂等性
GET <service-path>/<identifier> 获取<identifier>代表要检索的数据节点
PUT <service-path>/<identifier> 更新数据并返回状态;<identifier>代表要存储的数据节点
方法 URI格式 功能说明 幂等性
POST <service-path>/
1、创建一个节点并返回状态。
2、<identifier>指向要被存储的数据节点。
3、数据的根元素必须要有模块名称(JSON)。
DELETE <service-path>/<identifier>
1、删除一条数据并且返回状态。
2、<identifier>指向要被删除的数据。

iMaster NCE-Campus对REST接口的Headers进行了一定的限制,主要包括如下几个参数:

状态码 描述
2xx 200:操作成功,201:创建成功
400 操作失败,错误的详细描述在errmsg中体现
401 未授权,常见错误为token错误、或已超时
403 不允许访问,常见错误为该管理员无对应权限或访问的资源不存在
404 请求的资源不存在,常见错误为,尝试GET不存在的资源
415 不支持请求中的报文体格式,常见错误为,未填Content-Type,或Content-Type的值不为application/json
500 服务器内部错误,常见错误为请求header中缺少必填字段
为了安全性,REST API仅提供HTTPS接口。控制器作为Server,只支持TLS1.1和TLS1.2,且仅支持有限的密码组。客户端必须支持相应的SSL版本。