新同步组织结构¶

注：所有接口只针对旗舰会员提供，非旗舰会员无法调用，所有开放平台接口默认共享10QPS

同步考生数据可以方便的在之间进行考生数据交换，避免手动可能出现的错误；自动同步及时快捷，即可以同步考生信息也可以同步考生的组织结构。

分组管理¶

优manbet通过组来管理考生，可以把组理解为班级，部门；优manbet支持无限层级树状组管理，如下图所示

树状管理

1、插入组¶

插入组：¶

POST https://api.outsch.org/api/v1/student/addcategory

参数：¶

code=权限码&time=当前时间戳

参数说明：¶

code 每个账户唯一对应的验证码，string类型，旗舰会员及以上可在设置->开放平台设置中获取。
time 当前时间戳，例如1638768935。
parentGid 父节点id。如传0，代表插入根节点。
title 新建组组名。
Authorization 放到请求头的Token，详见示例代码。简单来说就是：将当前时间戳和您的code拼接起来，进行MD5加密而得。

如果操作成功,则返回：¶

{
    "gid":2995, //插入成功后的组id
    "status":"ok"
}

如果操作失败，则返回：¶

接口使用示例：¶

package main

import (
    "crypto/md5"
    "fmt"
    "io/ioutil"
    "log"
    "net/http"
    "net/url"
    "os"
    "strconv"
    "strings"
    "time"
)

const (
    Code = "xxx"
)

func main() {
    host := "https://api.outsch.org"
    resource := "/api/v1/student/addcategory"

    client := &http.Client{}
    fullPath := host + resource

    time64 := time.Now().UTC().Unix()

    data := make(url.Values)
    data["code"] = []string{Code}

    data["parentGid"] = []string{"0"}
    data["title"] = []string{"新建组"}

    data["time"] = []string{strconv.Itoa(int(time64))}

    req, _ := http.NewRequest(http.MethodPost, fullPath, strings.NewReader(data.Encode()))

    ParseToken := fmt.Sprintf("%x", md5.Sum([]byte(strconv.FormatInt(time64, 10)+Code)))
    req.Header.Set("Authorization", ParseToken)

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")

    resp, err := client.Do(req)
    if err != nil {
        log.Println(err)
        return
    }

    defer resp.Body.Close()

    b, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        log.Println(err)
        return
    }

    fmt.Println(string(b))
    f, _ := os.OpenFile("test.txt", os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0644)
    f.Write(b)
}

2、编辑组名称¶

编辑组名称：¶

POST https://api.outsch.org/api/v1/student/renamegroup

参数：¶

code=权限码&time=当前时间戳

参数说明：¶

code 每个账户唯一对应的验证码，string类型，旗舰会员及以上可在设置->开放平台设置中获取。
time 当前时间戳，例如1638768935。
gid 被修改组的组id。
title 新组名。
Authorization 放到请求头的Token，详见示例代码。简单来说就是：将当前时间戳和您的code拼接起来，进行MD5加密而得。

如果操作成功,则返回：¶

{
    "gid":2995,
    "oldTitle":"新建组", //旧组名
    "status":"ok"
}

如果操作失败，则返回：¶

接口使用示例：¶

package main

import (
    "crypto/md5"
    "fmt"
    "io/ioutil"
    "log"
    "net/http"
    "net/url"
    "os"
    "strconv"
    "strings"
    "time"
)

const (
    Code = "xxx"
)

func main() {
    host := "https://api.outsch.org"
    resource := "/api/v1/student/renamegroup"

    client := &http.Client{}
    fullPath := host + resource

    time64 := time.Now().UTC().Unix()

    data := make(url.Values)
    data["code"] = []string{Code}

    data["gid"] = []string{"2995"}
    data["title"] = []string{"新组名"}

    data["time"] = []string{strconv.Itoa(int(time64))}

    req, _ := http.NewRequest(http.MethodPost, fullPath, strings.NewReader(data.Encode()))

    ParseToken := fmt.Sprintf("%x", md5.Sum([]byte(strconv.FormatInt(time64, 10)+Code)))
    req.Header.Set("Authorization", ParseToken)

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")

    resp, err := client.Do(req)
    if err != nil {
        log.Println(err)
        return
    }

    defer resp.Body.Close()

    b, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        log.Println(err)
        return
    }

    fmt.Println(string(b))
    f, _ := os.OpenFile("test.txt", os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0644)
    f.Write(b)
}

3、删除组¶

删除组：¶

POST https://api.outsch.org/api/v1/student/delGroup

参数：¶

code=权限码&time=当前时间戳

参数说明：¶

code 每个账户唯一对应的验证码，string类型，旗舰会员及以上可在设置->开放平台设置中获取。
time 当前时间戳，例如1638768935。
gid 被删除组的组id。
Authorization 放到请求头的Token，详见示例代码。简单来说就是：将当前时间戳和您的code拼接起来，进行MD5加密而得。

如果操作成功,则返回：¶

{
    "status":"ok"
}

如果操作失败，则返回：¶

接口使用示例：¶

package main

import (
    "crypto/md5"
    "fmt"
    "io/ioutil"
    "log"
    "net/http"
    "net/url"
    "os"
    "strconv"
    "strings"
    "time"
)

const (
    Code = "xxx"
)

func main() {
    host := "https://api.outsch.org"
    resource := "/api/v1/student/delGroup"

    client := &http.Client{}
    fullPath := host + resource

    time64 := time.Now().UTC().Unix()

    data := make(url.Values)
    data["code"] = []string{Code}

    data["gid"] = []string{"2996"}

    data["time"] = []string{strconv.Itoa(int(time64))}

    req, _ := http.NewRequest(http.MethodPost, fullPath, strings.NewReader(data.Encode()))

    ParseToken := fmt.Sprintf("%x", md5.Sum([]byte(strconv.FormatInt(time64, 10)+Code)))
    req.Header.Set("Authorization", ParseToken)

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")

    resp, err := client.Do(req)
    if err != nil {
        log.Println(err)
        return
    }

    defer resp.Body.Close()

    b, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        log.Println(err)
        return
    }

    fmt.Println(string(b))
    f, _ := os.OpenFile("test.txt", os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0644)
    f.Write(b)
}

4、移动组¶

移动组：¶

POST https://api.outsch.org/api/v1/student/mvgroup

参数：¶

code=权限码&time=当前时间戳

参数说明：¶

code 每个账户唯一对应的验证码，string类型，旗舰会员及以上可在设置->开放平台设置中获取。
time 当前时间戳，例如1638768935。
gid 被移动组的组id。
mvToGid 目标组id。
Authorization 放到请求头的Token，详见示例代码。简单来说就是：将当前时间戳和您的code拼接起来，进行MD5加密而得。

如果操作成功,则返回：¶

{
    "status":"ok"
}

如果操作失败，则返回：¶

接口使用示例：¶

package main

import (
    "crypto/md5"
    "fmt"
    "io/ioutil"
    "log"
    "net/http"
    "net/url"
    "os"
    "strconv"
    "strings"
    "time"
)

const (
    Code = "xxx"
)

func main() {
    host := "https://api.outsch.org"
    resource := "/api/v1/student/mvgroup"

    client := &http.Client{}
    fullPath := host + resource

    time64 := time.Now().UTC().Unix()

    data := make(url.Values)
    data["code"] = []string{Code}

    data["gid"] = []string{"2996"}
    data["mvToGid"] = []string{"2995"}

    data["time"] = []string{strconv.Itoa(int(time64))}

    req, _ := http.NewRequest(http.MethodPost, fullPath, strings.NewReader(data.Encode()))

    ParseToken := fmt.Sprintf("%x", md5.Sum([]byte(strconv.FormatInt(time64, 10)+Code)))
    req.Header.Set("Authorization", ParseToken)

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")

    resp, err := client.Do(req)
    if err != nil {
        log.Println(err)
        return
    }

    defer resp.Body.Close()

    b, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        log.Println(err)
        return
    }

    fmt.Println(string(b))
    f, _ := os.OpenFile("test.txt", os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0644)
    f.Write(b)
}

5、获取组列表¶

获取组列表：¶

GET https://api.outsch.org/api/v1/student/lsgroups?code=权限码&time=当前时间戳

参数：¶

code=权限码&time=当前时间戳

参数说明：¶

code 每个账户唯一对应的验证码，string类型，旗舰会员及以上可在设置->开放平台设置中获取。
time 当前时间戳，例如1638768935。
gid(可选) 代表仅查询当前组下的子组。如要查询所有组，不需要传该值。
Authorization 放到请求头的Token，详见示例代码。简单来说就是：将当前时间戳和您的code拼接起来，进行MD5加密而得。

如果操作成功,则返回：¶

{
    "data":[
        {
            "gid":2989,
            "title":"2989组名"
        },
        {
            "gid":2987,
            "title":"2987组名"
        }
    ],
    "status":"ok"
}

//备注:返回组列表为当前组的子组,不包括孙子组,且如某一组内没有学生,不会出现在组列表中.

如果操作失败，则返回：¶

接口使用示例：¶

package main

import (
    "crypto/md5"
    "fmt"
    "io/ioutil"
    "log"
    "net/http"
    "os"
    "strconv"
    "time"
)

const (
    Code = "xxx"
)

func main() {
    host := "https://api.outsch.org"
    resource := "/api/v1/student/lsgroups"

    client := &http.Client{}
    fullPath := host + resource

    req, _ := http.NewRequest(http.MethodGet, fullPath, nil)
    time64 := time.Now().UTC().Unix()
    ParseToken := fmt.Sprintf("%x", md5.Sum([]byte(strconv.FormatInt(time64, 10)+Code)))
    req.Header.Set("Authorization", ParseToken)

    q := req.URL.Query()
    q.Add("code", Code)

    q.Add("gid", "2988")

    q.Add("time", strconv.Itoa(int(time64)))

    req.URL.RawQuery = q.Encode()

    resp, err := client.Do(req)
    if err != nil {
        log.Println(err)
        return
    }

    defer resp.Body.Close()

    b, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        log.Println(err)
        return
    }

    // fmt.Println(string(b))
    f, _ := os.OpenFile("test.txt", os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0644)
    f.Write(b)
}