考生數據管理接口¶

注：所有接口只針對旗艦會員提供，非旗艦會員無法調用，所有開放平臺接口默認共享10QPS

1、獲取考生字段信息¶

獲取考生字段信息：¶

GET https://api.kyexam.com/api/v1/student/getFields?code=xxx&time=當前時間戳

參數：¶

code=權限碼&time=當前時間戳

參數說明：¶

code 每個賬戶唯一對應的驗證碼，string類型，旗艦會員及以上可在系統設置->開放平臺設置中獲取。
time 當前時間戳，例如1638768935。
Authorization 放到請求頭的Token，詳見示例代碼。簡單來說就是：將當前時間戳和您的code拼接起來，進行MD5加密而得。

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

{
    "data":[
        {
            "sfid":1,
            "label":"姓名"
        },
        {
            "sfid":2,
            "label":"性別"
        },
        {
            "sfid":4,
            "label":"手機"
        },
        {
            "sfid":10,
            "label":"密碼"
        }
    ],
    "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/getFields"

    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("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)
}

2、批量插入考生信息¶

批量插入考生信息：¶

POST https://api.kyexam.com/api/v1/student/addStudents

參數：¶

code=權限碼&time=當前時間戳

參數說明：¶

code 每個賬戶唯一對應的驗證碼，string類型，旗艦會員及以上可在系統設置->開放平臺設置中獲取。
time 當前時間戳，例如1638768935。
info 要插入的數據。
Authorization 放到請求頭的Token，詳見示例代碼。簡單來說就是：將當前時間戳和您的code拼接起來，進行MD5加密而得。

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

{
    "fail":[
        //如插入失敗,返回數據對應的下標位置
    ],
    "status":"ok",
    "success":[//插入成功的數據...
        {
            "sid":170603,//插入后學生的sid
            "index":1 //數據所在傳入數據的位置
        },
        {
            "sid":170604,
            "index":2
        }
    ]
}

如果操作失敗，則返回：¶

接口使用示例：¶

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/addStudents"

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

    info := `
[
    {
        "gid": "2993",
        "fields": [
            {
                "sfid": 4,
                "value": "2993"
            },
            {
                "sfid": 1,
                "value": "stufor2993"
            }
        ]
    },
    {
        "gid": "2994",
        "fields": [
            {
                "sfid": 10,
                "value": "2994"
            },
            {
                "sfid": 1,
                "value": "stufor2994"
            }
        ]
    }
]
    `
    time64 := time.Now().UTC().Unix()

    data := make(url.Values)
    data["code"] = []string{Code}
    data["info"] = []string{info}
    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/changeStuinfo

參數：¶

code=權限碼&time=當前時間戳

參數說明：¶

code 每個賬戶唯一對應的驗證碼，string類型，旗艦會員及以上可在系統設置->開放平臺設置中獲取。
time 當前時間戳，例如1638768935。
info 要插入的數據。
Authorization 放到請求頭的Token，詳見示例代碼。簡單來說就是：將當前時間戳和您的code拼接起來，進行MD5加密而得。

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

{
    "fail":[
        //如失敗,返回數據對應的下標位置
    ],
    "status":"ok",
    "success":[
        "170603",//修改成功的sid
        "170604"
    ]
}

如果操作失敗，則返回：¶

接口使用示例：¶

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/changeStuinfo"

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

    info := `
[
    {
        "sid":170603,
        "loginValue": "",
        "fields": [
            {
                "sfid": 1,
                "value": "stufor2993change"
            },
            {
                "sfid": 4,
                "value": "18320320xxx"
            }
        ]
    },
    {
        "sid":170604,
        "loginValue": "",
        "fields": [
            {
                "sfid": 1,
                "value": "stufor2994change"
            },
            {
                "sfid": 10,
                "value": "29944"
            }
        ]
    }
]
    `

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

    data := make(url.Values)
    data["code"] = []string{Code}
    data["info"] = []string{info}
    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/delStu

參數：¶

code=權限碼&time=當前時間戳&sids=學生唯一id(二選一字段)

參數說明：¶

code 每個賬戶唯一對應的驗證碼，string類型，旗艦會員及以上可在系統設置->開放平臺設置中獲取。
time 當前時間戳，例如1638768935。
sids(二選一) 學生唯一id。格式如下：[170603,170604] 也可參照實例代碼
loginValues(二選一) 管理員設定的登錄字段，例如名字，手機等。格式如下： ["李三","張四"] 也可參照實例代碼
Authorization 放到請求頭的Token，詳見示例代碼。簡單來說就是：將當前時間戳和您的code拼接起來，進行MD5加密而得。

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

{
    "fail":[
        //如失敗,返回數據對應的下標位置
    ],
    "status":"ok",
    "success":[
        "170603",//刪除成功的sid
        "170604"
    ]
}

如果操作失敗，則返回：¶

接口使用示例：¶

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/delStu"

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

    sids := "[170603,170604]"
    // loginValues := "[\"登錄字段xx\",\"登錄字段xxx\"]"

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

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

    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、移動考生到組¶

移動考生到組：¶

POST https://api.kyexam.com/api/v1/student/movestugroup

參數：¶

code=權限碼&time=當前時間戳

參數說明：¶

code 每個賬戶唯一對應的驗證碼，string類型，旗艦會員及以上可在系統設置->開放平臺設置中獲取。
time 當前時間戳，例如1638768935。
mvStuInfo 格式請參照示例代碼，在loginValues與sid中任選其一。
Authorization 放到請求頭的Token，詳見示例代碼。簡單來說就是：將當前時間戳和您的code拼接起來，進行MD5加密而得。

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

{
    "fail":[
        //如失敗,返回數據對應的下標位置
    ],
    "status":"ok",
    "success":[
        "170606",//移動成功的sid
        "170607"
    ]
}

如果操作失敗，則返回：¶

接口使用示例：¶

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/movestugroup"

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

    mvStuInfo := `
    {
        "gids": [2993],
        "loginValues":[],                
        "sid":[170606,170607],
        "action": "moveto" 
    }
`

    /*
        上面以sid為例,如使用loginValues 格式如下  ["登錄字段1","登錄字段2"]
        action 可以為 addto moveto delfrom
        addto: 表示添加到組，這個時候一個考生可能存在多個組
        moveto: 表示移動到組，這個時候考生只存在傳入的組
        delfrom: 表示考生從指定組移除，需注意移除后至少應還存在一個組中,否則移除失敗
    */

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

    data := make(url.Values)
    data["code"] = []string{Code}
    data["mvStuInfo"] = []string{mvStuInfo}
    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)
}

6、獲取考生信息¶

獲取考生信息：¶

POST https://api.kyexam.com/api/v1/student/getstudentsinfo

參數：¶

code=權限碼&time=當前時間戳

參數說明：¶

code 每個賬戶唯一對應的驗證碼，string類型，旗艦會員及以上可在系統設置->開放平臺設置中獲取。
time 當前時間戳，例如1638768935。
loginValues(二選一字段) 管理員設定的登錄字段，例如名字，手機等。格式如下： ["李三","張四"] 也可參照實例代碼。
sids(二選一字段) 學生唯一id。格式如下：[170603,170604] 也可參照實例代碼。
Authorization 放到請求頭的Token，詳見示例代碼。簡單來說就是：將當前時間戳和您的code拼接起來，進行MD5加密而得。

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

{
    "data":[
        {
            "sid":170605,
            "fields":[
                {
                    "sFid":1,
                    "label":"姓名",
                    "value":"newstufor2993"
                }
            ],
            "group":[
                {
                    "gid":2993,
                    "title":"2993"
                }
            ]
        },
        {
            "sid":170606,
            "fields":[
                {
                    "sFid":1,
                    "label":"姓名",
                    "value":"newstufor2994"
                }
            ],
            "group":[
                {
                    "gid":2993,
                    "title":"2993"
                }
            ]
        }
    ],
    "fail":[
        //如失敗,返回對應的sid或loginValues,這種情況可能是因為考生已被刪除
    ],
    "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/getstudentsinfo"

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

    // sids := "[170603,170604]"
    sids := "[170605,170606]"
    // loginValues := "[\"登錄字段xx\",\"登錄字段xxx\"]"

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

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

    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)
}

7、獲取考生列表¶

獲取考生列表：¶

POST https://api.kyexam.com/api/v1/student/getstulist

參數：¶

code=權限碼&time=當前時間戳

參數說明：¶

code 每個賬戶唯一對應的驗證碼，string類型，旗艦會員及以上可在系統設置->開放平臺設置中獲取。
time 當前時間戳，例如1638768935。
start 分頁參數。
limit 查詢個數，最大為100。
Authorization 放到請求頭的Token，詳見示例代碼。簡單來說就是：將當前時間戳和您的code拼接起來，進行MD5加密而得。

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

{
    "data":[
        {
            "loginValue":"newstufor2993",
            "fields":[
                {
                    "sFid":1,
                    "label":"姓名",
                    "value":"newstufor2993"
                },
                {
                    "sFid":4,
                    "label":"手機",
                    "value":"2993"
                }
            ]
        },
        {
            "loginValue":"newstufor2994",
            "fields":[
                {
                    "sFid":1,
                    "label":"姓名",
                    "value":"newstufor2994"
                },
                {
                    "sFid":10,
                    "label":"密碼",
                    "value":"2994"
                }
            ]
        },
        {
            "loginValue":"newstufor29942",
            "fields":[
                {
                    "sFid":1,
                    "label":"姓名",
                    "value":"newstufor29942"
                },
                {
                    "sFid":10,
                    "label":"密碼",
                    "value":"2994"
                }
            ]
        }
    ],
    "status":"ok",
    "total":12
}

如果操作失敗，則返回：¶

接口使用示例：¶

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/getstulist"

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

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

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

    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)
}

8、獲取所有考生或者單一考生的考試記錄¶

獲取考生列表：¶

GET https://api.kyexam.com/api/v1/student/queryresults

參數：¶

code=權限碼&time=當前時間戳

參數說明：¶

code 每個賬戶唯一對應的驗證碼，string類型，旗艦會員及以上可在系統設置->開放平臺設置中獲取。
time 當前時間戳，例如1638768935。
start 分頁參數。
limit 查詢個數，最大為100。
loginValues 如需查詢單個考生的考試記錄，需配合eid使用。
eid 如需查詢單個考生的考試記錄，需配合loginValues使用，詳見示例代碼。
Authorization 放到請求頭的Token，詳見示例代碼。簡單來說就是：將當前時間戳和您的code拼接起來，進行MD5加密而得。

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

{
    "data":[
        {
            "viewResult":"https://api.kyexam.com/transgetresult?tid=xxx\u0026token=xxx", //試卷詳情鏈接,其中 '\u0026' 為 '&' 符號, 需要轉碼方可正常使用。
            "score":"2",//分數
            "passed":"0",//考試是否及格
            "status":"1",
            "startTime":"1639647217",//考試考試時間
            "endTime":"1639647236",//考試結束時間
            "sid":"170597",
            "loginValue":"n11",//登錄字段
            "name":"n11",//考生名字
            "eid":"107264"//試卷id
        },
        {
            "viewResult":"https://api.kyexam.com/transgetresult?tid=xxx\u0026token=xxx",
            "score":"1",
            "passed":"0",
            "status":"1",
            "startTime":"1639647122",
            "endTime":"1639647132",
            "sid":"170597",
            "loginValue":"n11",
            "name":"n11",
            "eid":"107264"
        }
    ],
    "status":"ok",
    "total":1877
}

如果操作失敗，則返回：¶

接口使用示例：¶

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/queryresults"

    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("start", "0")
    q.Add("limit", "2")
    //   ↑↑獲取所有考生考試數據↑↑

    // ↓↓獲取單一考生參與考試的記錄↓↓
    // q.Add("loginValues", "n11")
    // q.Add("eid", "107264")

    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)
}

优考试_国产伦精品一区二区三区_免费在线考试系统_国产伦精品一区二区三_培训考试系统_国产伦精品_题库系统_组卷答题系统_匡优考试

考生數據管理接口¶

1、獲取考生字段信息¶

獲取考生字段信息：¶

參數：¶

參數說明：¶

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

如果操作失敗，則返回：¶

接口使用示例：¶

2、批量插入考生信息¶

批量插入考生信息：¶

參數：¶

參數說明：¶

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

如果操作失敗，則返回：¶

接口使用示例：¶

3、批量修改考生信息¶

批量插入考生信息：¶

參數：¶

參數說明：¶

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

如果操作失敗，則返回：¶

接口使用示例：¶

4、批量刪除考生信息¶

批量刪除考生信息：¶

參數：¶

參數說明：¶

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

如果操作失敗，則返回：¶

接口使用示例：¶

5、移動考生到組¶

移動考生到組：¶

參數：¶

參數說明：¶

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

如果操作失敗，則返回：¶

接口使用示例：¶

6、獲取考生信息¶

獲取考生信息：¶

參數：¶

參數說明：¶

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

如果操作失敗，則返回：¶

接口使用示例：¶

7、獲取考生列表¶

獲取考生列表：¶

參數：¶

參數說明：¶

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

如果操作失敗，則返回：¶

接口使用示例：¶

8、獲取所有考生或者單一考生的考試記錄¶

獲取考生列表：¶

參數：¶

參數說明：¶

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

如果操作失敗，則返回：¶

接口使用示例：¶