menu

活动签到相关动作

更新时间: 2019-12-24 18:10:38 · 编辑者:宇链科技

公共活动注册

支持公益 / 志愿 / 公共活动。

上链类型

批量上链接口中使用下列名字(type)代表本上链类型。

voluntary-activity-register

上链参数

对应的 args 对象所含属性如下:

{
    "id": "活动 id",                            // 必选,在项目方数据库中能唯一找到项目的活动 id,请确保该 id 在同一个 `appId` 中不重复且可查询到项目情况,只能由大小写字母或数字组成,长度不超过 32 位
    "createTime": "1556592183531",              // 可选,活动的创建时间 (精确到毫秒的 UNIX 时间戳),请以数值形式传递
    "title": "一起打扫大街吧",                   // 可选,活动名称
    "desc": "今天我们隆重推出新项目:打扫大街。",  // 可选,活动描述
    "organization": "某公益组织",                // 可选,活动发起组织的名称
    "organizationId": "sd09203",               // 必选,活动发起组织的唯一 ID
    "openTime": "1556592183531",               // 可选,活动开始时间 (毫秒 UNIX 时间戳)
    "closeTime": "1556592193531",              // 可选,活动结束时间 (毫秒 UNIX 时间戳)
    "district": "江苏省苏州市姑苏区",            // 可选,活动区域
    "address": "张三大街225号",                 // 可选,活动地点
    "memo": "仅限党员参加",                     // 可选,活动备注
    "categories": [ "扫街" ],                    // 可选,活动类别,请以数组方式提供
    "x": {                                     // 可选,下面内容为加密内容
        ....                                   // 如果想加密上述字段中的可选字段,请直接将其移动到 x 属性中(id 和 organizationId 不允许加密)
    }
}

公共活动签到签退

公益 / 志愿 / 公共活动的签到,可选 GPS 或其他备注信息。

上链类型

批量上链接口中使用下列名字(type)代表本上链类型。

voluntary-activity-signIn (签到) voluntary-activity-signOut (签退)

上链参数

对应的 args 对象所含属性如下:

{
    "id": "sf09d78f",                                    // 必选,此次签到/签退的 id,长度不超过 32 位,只能由大小写字母或数字组成,在同一个 appId 中不能重复
    "parentId": "活动 id",                               // 必选,活动的id
    "userId": "签到/签退 id",                             // 必选,签到用户的 userId,同一个用户 id 必须相同
    "x": {                                               // x 属性下面的内容为银行级别加密
        "signerName": "张三",                            // 加密、可选,签到用户的姓名
        "gps": [ "1.4343", "2.35343" ],                  // 加密、可选,签到用户的 GPS
    },
    "createTime": "1556592183531",                       // 必选,签到/签退的时间(UNIX 毫秒时间戳)
    "durationInMinutes": "69",                           // 签退时可选,本次活动在线时长(以毫秒为单位,如果在线时长不等于签到签退时间差,本参数可以不传,需要额外调用时长核算接口)
    "memo": "xxx"                                        // 可选,备注
}

公共活动时长核算

有些情况下参与活动的累计时长可能和签到与签退的时间差不同,此时可以在调用签到、签退接口后再调用此接口记录该活动的有效时长。

上链类型

批量上链接口中使用下列名字(type)代表本上链类型。

voluntary-activity-durationCalc

上链参数

{
    "id": "sf09d78f",                                    // 必选,此次核算的 id,长度不超过 32 位,只能由大小写字母或数字组成,在同一个 appId 中不能重复
    "parentId": "活动 id",                               // 必选,活动的id
    "reference": [ "签到 id", "签退 id" ],                  // 必选,此次结算所涉及到的签到、签退的 id,目前必须是长度为2的数组
    "userId": "用户 id",                               // 必选,签到用户的 userId,同一个用户 id 必须相同
    "x": {                                                    // x 属性下面的内容为银行级别加密(可选)
        "signerName": "张三",                            // 加密、可选,签到用户的姓名
        "其他自定义key": "其他自定义内容",                  // 加密、可选,其他自定义内容
    },
    "createTime": "1556592183531",                       // 可选,时长的结算时间点(UNIX 毫秒时间戳)
    "durationInMinutes": "69",                           // 必须,本次活动在线时长(以毫秒为单位,根据活动规则,可以和签到签退时间有误差)
    "memo": "xxx"                                        // 可选,公开的备注
}