文档中心 > API类目 > 钉钉API

dingtalk.oapi.pbp.event.sync (打卡事件同步)

钉钉多场景打卡业务，开放小闹钟入口，接入方同步打卡事件到打卡平台。

公共参数

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

名称	类型	是否必须	描述
access_token	String	是	钉钉提供的授权Token，想了解详情，ISV开发者请点击这里，企业开发者请点击这里。若有疑问，咨询邮箱dingding_open_dingtalk#list.alibaba-inc.com。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
param	UserEventOapiRequestVo	必须			打卡事件参数模型
└ biz_code String 必须 meeting_check_in_dt_calendar 打卡业务代码 user_event_list UserEventOapiVo [] 必须打卡事件列表 └ userid String 必须 5c2f4657eb6378f 员工id └ event_name String 必须余杭门店巡查打卡事件名称 └ start_time Number 必须 1590138915000 打卡事件结束时间，单位毫秒 └ end_time Number 必须 1590166923000 打卡事件开始时间，单位毫秒 └ event_time_stamp Number 必须 1590138915000 打卡事件生成时间戳，单位毫秒 position_list PositionOapiVo [] 必须位置列表 └ position_id String 必须 8749809 位置点id └ position_type Number 必须 101 位置类型 └ biz_inst_id String 必须 43refadf8743 打卡业务实例id └ event_id String 必须 873439897343 打卡事件外部id，唯一键

响应参数

名称	类型	示例值	描述
errcode	Number	0	错误码
errmsg	String	OK	描述

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/pbp/event/sync");
OapiPbpEventSyncRequest req = new OapiPbpEventSyncRequest();
UserEventOapiRequestVo obj1 = new UserEventOapiRequestVo();
obj1.setBizCode("meeting_check_in_dt_calendar");
List<UserEventOapiVo> list3 = new ArrayList<UserEventOapiVo>();
UserEventOapiVo obj4 = new UserEventOapiVo();
list3.add(obj4);
obj4.setUserid("5c2f4657eb6378f");
obj4.setEventName("余杭门店巡查");
obj4.setStartTime(1590138915000L);
obj4.setEndTime(1590166923000L);
obj4.setEventTimeStamp(1590138915000L);
List<PositionOapiVo> list7 = new ArrayList<PositionOapiVo>();
PositionOapiVo obj8 = new PositionOapiVo();
list7.add(obj8);
obj8.setPositionId("8749809");
obj8.setPositionType(101L);
list5.setPositionList(list7);
obj4.setBizInstId("43refadf8743");
obj4.setEventId("873439897343");
obj1.setUserEventList(list3);
req.setParam(obj1);
OapiPbpEventSyncResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/pbp/event/sync");
OapiPbpEventSyncRequest req = new OapiPbpEventSyncRequest();
OapiPbpEventSyncRequest.UserEventOapiRequestVoDomain obj1 = new OapiPbpEventSyncRequest.UserEventOapiRequestVoDomain();
obj1.BizCode = "meeting_check_in_dt_calendar";
List<OapiPbpEventSyncRequest.UserEventOapiVoDomain> list3 = new List<OapiPbpEventSyncRequest.UserEventOapiVoDomain>();
OapiPbpEventSyncRequest.UserEventOapiVoDomain obj4 = new OapiPbpEventSyncRequest.UserEventOapiVoDomain();
list3.Add(obj4);
obj4.Userid = "5c2f4657eb6378f";
obj4.EventName = "余杭门店巡查";
obj4.StartTime = 1590138915000L;
obj4.EndTime = 1590166923000L;
obj4.EventTimeStamp = 1590138915000L;
List<OapiPbpEventSyncRequest.PositionOapiVoDomain> list6 = new List<OapiPbpEventSyncRequest.PositionOapiVoDomain>();
OapiPbpEventSyncRequest.PositionOapiVoDomain obj7 = new OapiPbpEventSyncRequest.PositionOapiVoDomain();
list6.Add(obj7);
obj7.PositionId = "8749809";
obj7.PositionType = 101L;
obj4.PositionList= list6;
obj4.BizInstId = "43refadf8743";
obj4.EventId = "873439897343";
obj1.UserEventList= list3;
req.Param_ = obj1;
OapiPbpEventSyncResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);

include "TopSdk.php";
date_default_timezone_set('Asia/Shanghai');

$c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_OAPI, DingTalkConstant::$METHOD_POST , DingTalkConstant::$FORMAT_JSON);
$req = new OapiPbpEventSyncRequest;
$param = new UserEventOapiRequestVo;
$param->biz_code="meeting_check_in_dt_calendar";
$user_event_list = new UserEventOapiVo;
$user_event_list->userid="5c2f4657eb6378f";
$user_event_list->event_name="余杭门店巡查";
$user_event_list->start_time="1590138915000";
$user_event_list->end_time="1590166923000";
$user_event_list->event_time_stamp="1590138915000";
$position_list = new PositionOapiVo;
$position_list->position_id="8749809";
$position_list->position_type="101";
$user_event_list->position_list = array($position_list);
$user_event_list->biz_inst_id="43refadf8743";
$user_event_list->event_id="873439897343";
$param->user_event_list = array($user_event_list);
$req->setParam($param);
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/pbp/event/sync");

curl -X POST "https://oapi.dingtalk.com/topapi/pbp/event/sync" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=0a428870-48d0-4af1-b1fb-2fe2536e003e' \
-d 'param=null'

# -*- coding: utf-8 -*-
import dingtalk.api

req=dingtalk.api.OapiPbpEventSyncRequest("https://oapi.dingtalk.com/topapi/pbp/event/sync")

req.param=""
try:
	resp= req.getResponse(access_token)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"dingtalk.oapi.pbp.event.sync");
add_param(pRequest,"param","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('dingtalk.oapi.pbp.event.sync', {
	'param':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "errcode":0,
    "errmsg":"OK"
}

异常示例

JSON示例

{
	"errcode":88,
	"errmsg":"ding talk error"
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.pbp.event.sync (打卡事件同步)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ