一、基本信息

---

接口名称：获取学校数据源字段

接口说明：根据数据源 ID 获取该数据源的字段定义（类型、标题、字段 KEY），用于组装查询与写入数据。

请求地址：${BASEURL}/dataconnectorserv/integration/basic/getSourceFields

请求方式：POST

请求类型：application/json

接口频率：接口调用上限500次/天

接口版本：1.1

修改日期：2026-08-07

小提示

1、调用接口前请先阅读：接入概述 > 接入流程 > API接入。

2、sourceID 请先通过「数据源接口 > 获取学校数据源列表」获取。

3、写入或解析数据时，请按返回的字段 KEY（key）与业务字段对应，不要依赖字段标题 name。

二、请求参数

---

参数名	类型	是否必填	说明
appKey	String	是	平台提供的唯一标识
schoolID	String	是	学校ID，从学校列表获取
sourceID	String	是	数据源ID，从数据源列表获取

{
    "appKey": "36s2zllw",
    "schoolID": "wca5opSRt2tyyBSLqOjdoS==",
    "sourceID": "1155898483207962634"
}

三、响应结果

---

响应参数名称	响应参数类型	是否有值	说明
Fields	Array	是	字段列表
dataType	String	是	字段类型
name	String	是	字段标题
key	String	是	字段KEY

{
    "code": 0,
    "status": "success",
    "result": {
        "Fields": [
            {
                "dataType": "String",
                "name": "学生账号",
                "key": "FormInput_1698229015807"
            },
            {
                "dataType": "String",
                "name": "学生姓名",
                "key": "FormInput_1698229015888"
            },
            {
                "dataType": "Number",
                "name": "语文-分数",
                "key": "FormNumberInput_1698229017448"
            },
            {
                "dataType": "String",
                "name": "创建日期",
                "key": "FormDate_1698229020416"
            }
        ]
    }
}