你可以通过该API获取所选表单的所有回复结果,并且可对该表单的回复数据进行其它操作。

GET /openapi/forms/:([0-9a-f]{24})/datas

curl请求示例:

curl https://fanqier.cn/openapi/forms/${formid}/datas?token=${token}&start=1546841293087&end=1546841293087&page=0&pagesize=100 // 网页版使用 fanqier.cn 域名

curl https://ding.fanqier.cn/openapi/forms/${formid}/datas?token=${token}&start=1546841293087&end=1546841293087&page=0&pagesize=100 // 钉钉版使用 ding.fanqier.cn 域名

curl --header "x-open-api-token: ${token}" https://fanqier.cn/openapi/forms/${formid}/datas

【${}】符号属于显示用的占位符, formid替换时,该占位符也要去掉

请求query字段数据说明列表

字段名 类型 描述
start Number 时间过滤:开始时间,毫秒值,可选
end Number 时间过滤:结束时间,毫秒值,可选
page Number 分页当前页 从0开始
pagesize Number 分页的每页数量 默认1000 最大不超过5000

返回数据详情及字段说明

返回值示例:

{
    "data": {
        "count": 1, // 表单回复数据的总数
        "list": [{
            "_id": "5a31e7cd316b7d5c82452877",
            "lastUpdated": "2017-12-14T02:54:05.860Z",
            "created": "2017-12-14T02:54:05.860Z",
            "isStar": false,
            "totalAmount": 0,
            "score": 0,
            "values": [{
                "type": "radio",
                "selectedItem": "选项 1",
                "selectedId": "5a308c8047af3deb100001e1",
                "definition": "5a308c8047af3deb100001e0"
            }, {
                "type": "name",
                "isContact": true,
                "value": "卡卡西",
                "definition": "5a308cbe47af3deb1000020e"
            }]
        }]
    },
    "status": {
        "code": 200,
        "message": "success"
    }
}

status字段仅用于表明返回状态,data字段中包含所有的信息


data字段数据说明列表

字段名 类型 描述
_id String 该条数据的唯一标识符
created Date 表单数据创建时间
lastUpdated Date 表单数据最后修改时间
isStar Boolean 是否为标记加星
totalAmount int 支付表单的总金额
score int 评分表单有效,值为该回复的分数
values Array 数组,包含表单每个组件的回复,详情参见:数据组件定义
duration Number 填表耗时(毫秒值)
remark String 备注
sharedUser Object 分发人 { name: 姓名, userid: 番茄id, jobnumber: 工号}
extendField String 扩展属性设置的取值