跳转至

新同步组织结构接口

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

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

分组管理

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

树状管理

1、插入组

插入组：

POST https://api.kyexam.com/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.kyexam.com"
    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.kyexam.com/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.kyexam.com"
    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.kyexam.com/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.kyexam.com"
    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.kyexam.com/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.kyexam.com"
    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.kyexam.com/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.kyexam.com"
    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)
}
优惠活动
体验考试
[扫码体验考试]
微信咨询
[微信咨询服务]
电话咨询
电话咨询
电话 020-28165026
在线咨询