员工信息同步

批量同步员工生日和入职日

员工的生日和入职日,管理员除可以在管理后台的祝福应用中手工单个设置或批量导入外,还可以利用本接口,将其自动同步到乐享平台。

接口调用说明:

PUT https://lxapi.lexiangla.com/cgi-bin/v1/wish/staffs-anniversaries

参数说明:

参数 是否必须 说明
staffs 员工生日入职日信息列表,每一项包含以下数据:

staffs字段说明:

参数 是否必须 说明
corp_staff_id 员工企业微信账号
birtday_calendar 员工生日日历。按阳历过生日,选solar;按阴历过生日,选lunar。默认solar。
solar_birthday_date 阳历生日。过阴历生日的,也要使用出生日当天的阳历日期。
solar_entryday_date 员工入职日。

注:可只设置员工生日或入职日,可同时设置,可指定员工过阴历生日(默认阳历)。 生日或入职日字段为日期格式,支持"yyyy-mm-dd", "yyyy/mm/dd", "yyyy年mm月dd日"格式。

SDK封装方法使用示例(一):

$staffs = [
    [
        'corp_staff_id' => 'TaoTao1',
        'birtday_calendar' => 'solar',
        'solar_birthday_date' => '1988-10-25',
        'solar_entryday_date' => '2016-7-21',
    ],
    [
        'corp_staff_id' => 'viky',
        'birtday_calendar' => 'lunar',
        'solar_birthday_date' => '1988/10/25',
    ],
    [
        'corp_staff_id' => '',
        'solar_birthday_date' => '1988/10/24',
    ],
];
$results = $api->forStaff($corp_staff_id)->putStaffsAnniversaries($staffs);
echo json_encode($results);

返回说明:

200 OK 状态码
{
  "code": 0,
  "data": {
    "total_staff_count": 3,
    "success_staff_count": 2,
    "failed_staff_count": 1,
    "error_rows": [
      {
        "corp_staff_id": "",
        "solar_birthday_date": "1988\/10\/24",
        "error_msgs": [
          "corp_staff_id empty"
        ]
      }
    ]
  }
}

如果请求数据中有错误,返回数据中error_rows会给出错误数据行及出错消息。

SDK封装方法使用示例(二):

$results = $api->forStaff($corp_staff_id)->putStaffsAnniversaries([]);
echo json_encode($results);

返回说明:

200 OK 状态码

没有提供staffs参数或提供的staffs参数为空:

{
  "code": "61001",
  "message": "`staffs` empty in request data",
  "data": {
    "request_data": {
      "staffs": []
    }
  }
}