查询闲忙

查询用户默认日历的闲忙信息

请求

基本
HTTP URL	https://hi-qa.weizhipin.com/open-apis/calendar/v2/freebusy/list
HTTP Method	POST
支持的应用类型	自建应用
权限要求 开启任一权限即可	获取日历、日程及忙闲信息

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560"
Content-Type	string	是	固定值："application/json; charset=utf-8"

查询参数

名称	类型	描述
user_id_type	string	用户 ID 类型示例值："open_id" 可选值有： open_id：用户的 open id union_id：用户的 union id user_id：用户的 user id 默认值：open_id 当值为 user_id，字段权限要求： 获取用户 user ID

请求体

名称	类型	必填	描述
time_min	string	是	查询时段开始时间 示例值："2022-09-02 00:00"
time_max	string	是	查询时段结束时间 示例值："2022-09-10 23:59"
user_id	string	是	用户user_id。 示例值："ou_xxxxxxxxxx"

请求体示例

{
    "user_id":"1000001",
    "time_min":"2022-09-02 00:00",
    "time_max":"2022-09-02 23:59"
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	list	-
∟start_time	string	用户忙碌开始时间 示例值："2022-09-10 00:00"
∟end_time	string	用户忙碌结束时间 示例值："2022-09-10 00:00"

响应体示例

{
    "code": 0,
    "traceId": "_Ao59UOIBLPCeAAu",
    "success": true,
    "data": [
        {
            "start_time": "2022-09-02 15:00",
            "end_time": "2022-09-02 16:00"
        },
        {
            "start_time": "2022-09-02 17:00",
            "end_time": "2022-09-02 18:00"
        }
    ],
    "msg": "操作成功"
}