北森 API

获取打卡数据

POST

/AttendanceOpen/api/v1/SwipingCardData/GetSwipingCards

接口限制：100次/秒/企业 3000次/分钟/企业

适用场景：根据打卡日期获取对应打卡数据

警告信息：-

tips：同步执行，查询页位置从1开始，每次查询数量默认100条，最多300条；根据日期查询。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://openapi.italent.cn/AttendanceOpen/api/v1/SwipingCardData/GetSwipingCards' \
--header 'Content-Type: application/json' \
--data-raw '{
	"PunchCardDate": "2020-07-23",
	"PageIndex": 1,
	"PageSize": 100
}'

响应示例

{
  "Data": {
    "SwipingCardDetails": [
      {
        "UserEmail": "string",
        "StaffId": 0,
        "CardNumber": "string",
        "PunchCardDate": "2019-08-24T14:15:22Z",
        "SwipingCardDateTime": "2019-08-24T14:15:22Z",
        "PunchCardTime": "2019-08-24T14:15:22Z",
        "CheckinType": "string",
        "LocationDetail": "string",
        "DataSource": "string",
        "SwipingCardType": "string",
        "LocationTitle": "string",
        "WifiName": "string",
        "Notes": "string",
        "FacilityIdentify": "string",
        "SigninRegion": "string",
        "WgsCoordate": "string",
        "SigninResult": true,
        "WifiMacAddress": "string",
        "IsWifiSignin": true,
        "ClockType": "string",
        "Lat": "string",
        "Lng": "string",
        "CoordinateSystem": "string",
        "CreatedTime": "2019-08-24T14:15:22Z",
        "ModifiedTime": "2019-08-24T14:15:22Z"
      }
    ],
    "Total": 0
  },
  "Code": "Succeed",
  "Message": "string"
}

请求参数

Body 参数application/json

PunchCardDate

string <date-time>

必需

打卡日期示例格式“2020-11-11”

PageIndex

integer <int32>

可选

查询页起始位置，必须大于0，默认1

PageSize

integer <int32>

可选

每页数量，默认100，最高设置300

示例

返回响应

🟢200OK

application/json

Body

Data

object

可选

SwipingCardDetails

array [object {25}]

具体打卡数据

可选

Total

integer <int32>

可选

数据总量，如：100

Code

enum<string>

可选

返回状态编码
200 成功
206 部分成功
401 无权限
417 失败

枚举值:

SucceedPartSucceedNoPermissionFailed

Message

string

错误信息

可选

修改于 2021-10-13 10:54:22

北森假勤团队内部使用

接收打卡数据【考勤】