sdlan web api文档

sdlan为前端提供了若干api。其中，所有的api都使用POST方法，将数据以json消息体的方式提交给服务端。服务端根据具体处理结果，返回json数据。

1. 返回消息体

sdlan api的所有返回的消息体都遵循如下格式：

{
    "code": $int,
    "message": $object,
    "error": $string,
}

其中，code为0代表请求成功，返回的内容存放在message字段，error字段为空字符串；反之，如果请求失败，则code不为0，同时，message为空字符串，error字段为错误描述字符串。

在后面的描述中，如果请求成功，则默认返回的code为0，error为空字符串，而message会写明结构；如果返回失败，则message为空字符串，code和error会根据情况标明。

2. 消息请求参数说明

在实际操作过程中，用户会需要先注册，注册成功之后，需要先使用用户名和密码进行登录，密码验证成功之后，后台会返回一个token，该token有效期为一个小时，在登录成功之后所有其他的接口（即除了register和login接口），在发起请求的时候，都需要在请求头的header里面带上token，否则会权限热症失败，返回code为400，error为“unauthorized”

3. 实际接口

实际接口分成几个类别列举。

4.1. 用户操作

用户操作包括用户注册，登录，登出，创建/删除/查看register-token(用于节点登录时填写的token);修改密码等一系列关于用于的操作。

4.2. 网络操作

网络操作主要包括网络的创建、列举、删除、路由（给网络添加、删除一系列路由信息）等操作。

4.3. 节点操作

节点操作包括对节点的授权、取消授权、在网络之间移动等操作。

4.3.1 授权节点

该接口用于对未授权的节点进行授权操作。

POST /peer/authorize

1.9 KiB Raw Blame History Unescape Escape