时间条目

时间输入对象

属性 类型 描述
id 整数 时间条目的唯一ID。
spent_date 日期 时间输入日期。
用户 对象 包含关联用户的id和名称的对象。
user_assignment 对象 一个用户分配对象关联用户的。
客户端 对象 包含关联客户端的id和名称的对象。
项目 对象 包含关联项目的id和名称的对象。
任务 对象 包含关联任务的id和名称的对象。
task_assignment 对象 一个任务分配对象关联任务的。
external_reference 对象 对象,该对象包含idgroup_idaccount_id永久链接服务,service_icon_url关联的外部引用的。
发票 对象 一旦时间条目被开具发票,这个字段将包括相关发票的id和编号。
小时 小数 在此时间条目中跟踪的(十进制时间)小时数。
hours_without_timer 小数 在计时器最后一次启动之前,该时间条目中已经跟踪的(十进制时间)小时数。
rounded_hours 小数 在汇总报告和发票中使用的时间条目中跟踪的(十进制时间)小时数。属性将此值四舍五入时间排在您的首选项
笔记 字符串 附在时间分录上的注释。
is_locked 布尔 时间条目是否被锁定。
locked_reason 字符串 为什么时间条目被锁定了。
is_closed 布尔 工时输入是否已通过工时表审批批准。
is_billed 布尔 工时分录是否已标记为发票。
timer_started_at datetime 定时器启动的日期和时间(如果按持续时间跟踪)。bob手机下载使用ISO 8601格式
started_time 时间 时间条目开始的时间(如果按开始/结束时间跟踪)。bob手机下载
ended_time 时间 时间条目结束的时间(如果按开始/结束时间跟踪)。bob手机下载
is_running 布尔 时间条目当前是否正在运行。
计费 布尔 工时录入是否计费。
预算 布尔 时间分录是否计入项目预算。
billable_rate 小数 时间录入的计费费率。
cost_rate 小数 时间录入的成本率。
created_at datetime 创建时间条目的日期和时间。使用ISO 8601格式
updated_at datetime 最后更新时间条目的日期和时间。使用ISO 8601格式

需要的权限

管理员可以查看该帐户的所有时间条目。

管理人员可以看到自己的时间条目,分配的队友,以及跟踪到他们管理的项目的时间。此外,有权编辑指定队友的时间条目的经理可以代表他们创建、编辑和销毁时间条目。

成员只能看到自己跟踪的时间。

列出所有时间条目

返回时间条目的列表。时间条目按顺序返回spent_date日期。此时,排序选项不能自定义。

响应包含一个对象time_entries属性,该属性包含最多到的数组per_page时间条目。数组中的每个条目都是一个单独的时间条目对象。如果没有更多可用的时间项,则结果数组将为空。响应中还包括几个额外的分页属性,以简化对时间条目的分页。

获得/ v2 / time_entries
参数 类型 描述
user_id 整数 只返回属于具有给定ID的用户的时间条目。
client_id 整数 只返回属于具有给定ID的客户端的时间条目。
project_id 整数 只返回属于具有给定ID的项目的时间条目。
task_id 整数 只返回属于具有给定ID的任务的时间项。
external_reference_id 字符串 只返回给定的时间项external_referenceID。
is_billed 布尔 通过真正的仅返回已开具发票的时间条目返回未开票的工时分项。
is_running 布尔 通过真正的仅返回运行时项和返回非运行时项。
updated_since datetime 只返回自给定日期和时间以来更新过的时间项。使用ISO 8601格式
日期 只返回时间项spent_date在给定日期或之后
日期 只返回时间项spent_date在给定日期或之前。
页面 整数 在分页中使用的页码。例如,如果您提出一个列表请求并收到2000条记录,您的后续呼叫可以包括页面= 2检索列表的下一页。(默认值:1)
per_page 整数 每页要返回的记录数。取值范围为1 ~ 2000。(默认:2000)

示例请求:

curl "https://api.bob客服端下载harvestapp.com/v2/time_entries" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"

示例响应:

“time_entries”:【“id”636709355“spent_date”“2017-03-02”“用户”: {“id”1782959“名称”“金艾伦”},“客户端”: {“id”5735774“名称”“ABC集团”},“项目”: {“id”14307913“名称”“营销网站”},“任务”: {“id”8083365“名称”“平面设计”},“user_assignment”: {“id”125068553“is_project_manager”真正的“is_active”真正的“预算”“created_at”“2017 - 06 - 26 t22:32:52z”“updated_at”“2017 - 06 - 26 t22:32:52z”“hourly_rate”100.0},“task_assignment”: {“id”155502709“计费”真正的“is_active”真正的“created_at”“2017 - 06 - 26 t21:36:23z”“updated_at”“2017 - 06 - 26 t21:36:23z”“hourly_rate”100.0“预算”},“小时”2.11“hours_without_timer”2.11“rounded_hours”2.25“笔记”“添加CSS样式”“created_at”“2017 - 06 - 27 t15:50:15z”“updated_at”“2017 - 06 - 27 t16:47:14z”“is_locked”真正的“locked_reason”“此期间已批准并锁定的项目”“is_closed”真正的“is_billed”“timer_started_at”“started_time”“下午三点”“ended_time”“下午5:00”“is_running”“发票”“external_reference”“计费”真正的“预算”真正的“billable_rate”100.0“cost_rate”50.0},“id”636708723“spent_date”“2017-03-01”“用户”: {“id”1782959“名称”“金艾伦”},“客户端”: {“id”5735776“名称”“123”产业},“项目”: {“id”14308069“名称”“网上商店-第一期”},“任务”: {“id”8083366“名称”“编程”},“user_assignment”: {“id”125068554“is_project_manager”真正的“is_active”真正的“预算”“created_at”“2017 - 06 - 26 t22:32:52z”“updated_at”“2017 - 06 - 26 t22:32:52z”“hourly_rate”100.0},“task_assignment”: {“id”155505014“计费”真正的“is_active”真正的“created_at”“2017 - 06 - 26 t21:52:18z”“updated_at”“2017 - 06 - 26 t21:52:18z”“hourly_rate”100.0“预算”},“小时”1.35“hours_without_timer”1.35“rounded_hours”1.5“笔记”“进口产品”“created_at”“2017 - 06 - 27 t15:49:28z”“updated_at”“2017 - 06 - 27 t16:47:14z”“is_locked”真正的“locked_reason”“在此期间已开具发票、批准并锁定的项目”“is_closed”真正的“is_billed”真正的“timer_started_at”“started_time”“华”“ended_time”“2”“is_running”“发票”: {“id”13150403“数量”“1001”},“external_reference”“计费”真正的“预算”真正的“billable_rate”100.0“cost_rate”50.0},“id”636708574“spent_date”“2017-03-01”“用户”: {“id”1782959“名称”“金艾伦”},“客户端”: {“id”5735776“名称”“123”产业},“项目”: {“id”14308069“名称”“网上商店-第一期”},“任务”: {“id”8083369“名称”“研究”},“user_assignment”: {“id”125068554“is_project_manager”真正的“is_active”真正的“预算”“created_at”“2017 - 06 - 26 t22:32:52z”“updated_at”“2017 - 06 - 26 t22:32:52z”“hourly_rate”100.0},“task_assignment”: {“id”155505016“计费”“is_active”真正的“created_at”“2017 - 06 - 26 t21:52:18z”“updated_at”“2017 - 06 - 26 t21:54:06z”“hourly_rate”100.0“预算”},“小时”1.0“hours_without_timer”1.0“rounded_hours”1.0“笔记”评估第三方库“created_at”“2017 - 06 - 27 t15:49:17z”“updated_at”“2017 - 06 - 27 t16:47:14z”“is_locked”真正的“locked_reason”“此期间已批准并锁定的项目”“is_closed”真正的“is_billed”“timer_started_at”“started_time”“上午11点”“ended_time”“旧”“is_running”“发票”“external_reference”“计费”“预算”真正的“billable_rate”“cost_rate”50.0},“id”636707831“spent_date”“2017-03-01”“用户”: {“id”1782959“名称”“金艾伦”},“客户端”: {“id”5735776“名称”“123”产业},“项目”: {“id”14308069“名称”“网上商店-第一期”},“任务”: {“id”8083368“名称”“项目管理”},“user_assignment”: {“id”125068554“is_project_manager”真正的“is_active”真正的“预算”“created_at”“2017 - 06 - 26 t22:32:52z”“updated_at”“2017 - 06 - 26 t22:32:52z”“hourly_rate”100.0},“task_assignment”: {“id”155505015“计费”真正的“is_active”真正的“created_at”“2017 - 06 - 26 t21:52:18z”“updated_at”“2017 - 06 - 26 t21:52:18z”“hourly_rate”100.0“预算”},“小时”2.0“hours_without_timer”2.0“rounded_hours”2.0“笔记”“计划会议”“created_at”“2017 - 06 - 27 t15:48:24z”“updated_at”“2017 - 06 - 27 t16:47:14z”“is_locked”真正的“locked_reason”“在此期间已开具发票、批准并锁定的项目”“is_closed”真正的“is_billed”真正的“timer_started_at”“started_time”“早上”“ended_time”“上午11点”“is_running”“发票”: {“id”13150403“数量”“1001”},“external_reference”“计费”真正的“预算”真正的“billable_rate”100.0“cost_rate”50.0],“per_page”2000“total_pages”1“total_entries”4“next_page”“previous_page”“页面”1“链接”: {“第一”“https://api.bob客服端下载harvestapp.com/v2/time_entries?page=1&per_page=2000”“下一个”“以前”“最后一次”“https://api.bob客服端下载harvestapp.com/v2/time_entries?page=1&per_page=2000”

检索时间条目

检索具有给定ID的时间条目。返回一个时间条目对象和200好了提供有效标识符时的响应代码。

GET / v2 / time_entries / {TIME_ENTRY_ID}

示例请求:

curl "https://api.bob客服端下载harvestapp.com/v2/time_entries/636708723" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"

示例响应:

“id”636708723“spent_date”“2017-03-01”“用户”: {“id”1782959“名称”“金艾伦”},“客户端”: {“id”5735776“名称”“123”产业},“项目”: {“id”14308069“名称”“网上商店-第一期”},“任务”: {“id”8083366“名称”“编程”},“user_assignment”: {“id”125068554“is_project_manager”真正的“is_active”真正的“预算”“created_at”“2017 - 06 - 26 t22:32:52z”“updated_at”“2017 - 06 - 26 t22:32:52z”“hourly_rate”100.0},“task_assignment”: {“id”155505014“计费”真正的“is_active”真正的“created_at”“2017 - 06 - 26 t21:52:18z”“updated_at”“2017 - 06 - 26 t21:52:18z”“hourly_rate”100.0“预算”},“小时”1.0“hours_without_timer”1.0“rounded_hours”1.0“笔记”“进口产品”“created_at”“2017 - 06 - 27 t15:49:28z”“updated_at”“2017 - 06 - 27 t16:47:14z”“is_locked”真正的“locked_reason”“在此期间已开具发票、批准并锁定的项目”“is_closed”真正的“is_billed”真正的“timer_started_at”“started_time”“华”“ended_time”“2”“is_running”“发票”: {“id”13150403“数量”“1001”},“external_reference”“计费”真正的“预算”真正的“billable_rate”100.0“cost_rate”50.0

通过持续时间创建一个时间条目

创建一个新的时间条目对象。返回一个时间条目对象和201年创建调用成功时的响应代码。

当帐户配置为时,应仅使用此方法创建时间条目通过持续时间跟踪时间.可以通过访问设置页面在您的Harvest帐bob客服端下载户或通过检查是否wants_timestamp_timers是假的公司的API

POST / v2 / time_entries
参数 类型 要求 描述
user_id 整数 可选 要与时间条目关联的用户ID。默认为当前通过身份验证的用户的ID。
project_id 整数 要求 要与时间条目关联的项目的ID。
task_id 整数 要求 要与时间条目关联的任务的ID。
spent_date 日期 要求 ISO 8601格式的日期条目花费的时间。
小时 小数 可选 跟踪的当前时间量。如果提供了,将使用指定的小时和创建时间条目is_running将被设置为false。如果没有提供,时间将设置为0.0而且is_running将设置为true。
笔记 字符串 可选 任何与时间条目相关联的注释。
external_reference 对象 可选 对象,该对象包含idgroup_idaccount_id,永久链接外部引用的。

示例请求:

curl "https://api.bob客服端下载harvestapp.com/v2/time_entries" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"\ -X POST \ -H "Content-Type: application/json" \ -d '{"user_id":1782959,"project_id":14307913,"task_id":8083365,"spent_date":"2017-03-21","hours":1.0}'

示例响应:

“id”636718192“spent_date”“2017-03-21”“用户”: {“id”1782959“名称”“金艾伦”},“客户端”: {“id”5735774“名称”“ABC集团”},“项目”: {“id”14307913“名称”“营销网站”},“任务”: {“id”8083365“名称”“平面设计”},“user_assignment”: {“id”125068553“is_project_manager”真正的“is_active”真正的“预算”“created_at”“2017 - 06 - 26 t22:32:52z”“updated_at”“2017 - 06 - 26 t22:32:52z”“hourly_rate”100.0},“task_assignment”: {“id”155502709“计费”真正的“is_active”真正的“created_at”“2017 - 06 - 26 t21:36:23z”“updated_at”“2017 - 06 - 26 t21:36:23z”“hourly_rate”100.0“预算”},“小时”1.0“rounded_hours”1.0“笔记”“created_at”“2017 - 06 - 27 t16:01:23z”“updated_at”“2017 - 06 - 27 t16:01:23z”“is_locked”“locked_reason”“is_closed”“is_billed”“timer_started_at”“started_time”“ended_time”“is_running”“发票”“external_reference”“计费”真正的“预算”真正的“billable_rate”100.0“cost_rate”50.0

通过开始时间和结束时间创建一个时间条目

创建一个新的时间条目对象。返回一个时间条目对象和201年创建调用成功时的响应代码。

当帐户配置为时,应仅使用此方法创建时间条目通过开始和结束时间跟踪时间.可以通过访问设置页面在您的Harvest帐bob客服端下载户或通过检查是否wants_timestamp_timers是正确的公司的API

POST / v2 / time_entries
参数 类型 要求 描述
user_id 整数 可选 要与时间条目关联的用户ID。默认为当前通过身份验证的用户的ID。
project_id 整数 要求 要与时间条目关联的项目的ID。
task_id 整数 要求 要与时间条目关联的任务的ID。
spent_date 日期 要求 ISO 8601格式的日期条目花费的时间。
started_time 时间 可选 输入开始的时间。默认为当前时间。例如:“上午8:00”。
ended_time 时间 可选 输入结束的时间。如果提供,is_running将被设置为false。如未提供,is_running将设置为true。
笔记 字符串 可选 任何与时间条目相关联的注释。
external_reference 对象 可选 对象,该对象包含idgroup_idaccount_id,永久链接外部引用的。

示例请求:

curl "https://api.bob客服端下载harvestapp.com/v2/time_entries" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"\ -X POST \ -H "Content-Type: application/json" \ -d '{"user_id":1782959,"project_id":14307913,"task_id":8083365,"spent_date":"2017-03-21"," start_time ":"8:00am"," endd_time ":"9:00am"}'

示例响应:

“id”636718192“spent_date”“2017-03-21”“用户”: {“id”1782959“名称”“金艾伦”},“客户端”: {“id”5735774“名称”“ABC集团”},“项目”: {“id”14307913“名称”“营销网站”},“任务”: {“id”8083365“名称”“平面设计”},“user_assignment”: {“id”125068553“is_project_manager”真正的“is_active”真正的“预算”“created_at”“2017 - 06 - 26 t22:32:52z”“updated_at”“2017 - 06 - 26 t22:32:52z”“hourly_rate”100.0},“task_assignment”: {“id”155502709“计费”真正的“is_active”真正的“created_at”“2017 - 06 - 26 t21:36:23z”“updated_at”“2017 - 06 - 26 t21:36:23z”“hourly_rate”100.0“预算”},“小时”1.0“hours_without_timer”1.0“rounded_hours”1.0“笔记”“created_at”“2017 - 06 - 27 t16:01:23z”“updated_at”“2017 - 06 - 27 t16:01:23z”“is_locked”“locked_reason”“is_closed”“is_billed”“timer_started_at”“started_time”“上午8:00“ended_time”“早上”“is_running”“发票”“external_reference”“计费”真正的“预算”真正的“billable_rate”100.0“cost_rate”50.0

更新时间条目

通过设置传递的参数值更新特定的时间条目。任何未提供的参数将保持不变。返回一个时间条目对象和200好了调用成功时的响应代码。

补丁/ v2 / time_entries / {TIME_ENTRY_ID}
参数 类型 描述
project_id 整数 要与时间条目关联的项目的ID。
task_id 整数 要与时间条目关联的任务的ID。
spent_date 日期 ISO 8601格式的日期条目花费的时间。
started_time 时间 输入开始的时间。默认为当前时间。例如:“上午8:00”。
ended_time 时间 输入结束的时间。
小时 小数 跟踪的当前时间量。
笔记 字符串 任何与时间条目相关联的注释。
external_reference 对象 对象,该对象包含idgroup_idaccount_id,永久链接外部引用的。

示例请求:

curl "https://api.bob客服端下载harvestapp.com/v2/time_entries/636718192" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"\ -X PATCH \ -H "Content-Type: application/json" \ -d '{"notes":"已更新的notes"}'

示例响应:

“id”636718192“spent_date”“2017-03-21”“用户”: {“id”1782959“名称”“金艾伦”},“客户端”: {“id”5735774“名称”“ABC集团”},“项目”: {“id”14307913“名称”“营销网站”},“任务”: {“id”8083365“名称”“平面设计”},“user_assignment”: {“id”125068553“is_project_manager”真正的“is_active”真正的“预算”“created_at”“2017 - 06 - 26 t22:32:52z”“updated_at”“2017 - 06 - 26 t22:32:52z”“hourly_rate”100.0},“task_assignment”: {“id”155502709“计费”真正的“is_active”真正的“created_at”“2017 - 06 - 26 t21:36:23z”“updated_at”“2017 - 06 - 26 t21:36:23z”“hourly_rate”100.0“预算”},“小时”1.0“hours_without_timer”1.0“rounded_hours”1.0“笔记”“更新笔记”“created_at”“2017 - 06 - 27 t16:01:23z”“updated_at”“2017 - 06 - 27 t16:02:40z”“is_locked”“locked_reason”“is_closed”“is_billed”“timer_started_at”“started_time”“ended_time”“is_running”“发票”“external_reference”“计费”真正的“预算”真正的“billable_rate”100.0“cost_rate”50.0

删除时间条目的外部引用

删除时间条目的外部引用。返回一个200好了调用成功时的响应代码。

删除/ v2 / time_entries / {TIME_ENTRY_ID} / external_reference

示例请求:

curl "https://api.bob客服端下载harvestapp.com/v2/time_entries/636718192/external_reference" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"\ -x删除

删除时间条目

删除时间表项。只有当时间条目未关闭且关联的项目和任务尚未存档时,才可以删除它。但是,管理员可以删除关闭的条目。返回一个200好了调用成功时的响应代码。

删除/ v2 / time_entries / {TIME_ENTRY_ID}

示例请求:

curl "https://api.bob客服端下载harvestapp.com/v2/time_entries/636718192" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"\ -x删除

重新启动已停止的时间条目

只有在时间条目当前未运行时才有可能重新启动它。返回一个200好了调用成功时的响应代码。

补丁/ v2 / time_entries / {TIME_ENTRY_ID} /重新启动

示例请求:

curl "https://api.bob客服端下载harvestapp.com/v2/time_entries/662202797/restart" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"\ -x补丁

示例响应:

“id”662204379“spent_date”“2017-03-21”“用户”“id”1795925“名称”“简·史密斯”},“客户端”“id”5735776“名称”“123”产业},“项目”“id”14808188“名称”“工作组”},“任务”“id”8083366“名称”“编程”},“user_assignment”“id”130403296“is_project_manager”真正的“is_active”真正的“预算”“created_at”“2017 - 08 - 22 - t17:36:54z”“updated_at”“2017 - 08 - 22 - t17:36:54z”“hourly_rate”One hundred.},“task_assignment”“id”160726645“计费”真正的“is_active”真正的“created_at”“2017 - 08 - 22 - t17:36:54z”“updated_at”“2017 - 08 - 22 - t17:36:54z”“hourly_rate”One hundred.“预算”},“小时”0“hours_without_timer”0“rounded_hours”0“笔记”“created_at”“2017 - 08 - 22 - t17:40:24z”“updated_at”“2017 - 08 - 22 - t17:40:24z”“is_locked”“locked_reason”“is_closed”“is_billed”“timer_started_at”“2017 - 08 - 22 - t17:40:24z”“started_time”“11:40am”“ended_time”“is_running”真正的“发票”“external_reference”“计费”真正的“预算”“billable_rate”One hundred.“cost_rate”75

停止运行时条目

只有当时间条目正在运行时才有可能停止它。返回一个200好了调用成功时的响应代码。

补丁/ v2 / time_entries / {TIME_ENTRY_ID} /停止

示例请求:

curl "https://api.bob客服端下载harvestapp.com/v2/time_entries/662202797/stop" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"\ -x补丁

示例响应:

“id”662202797“spent_date”“2017-03-21”“用户”“id”1795925“名称”“简·史密斯”},“客户端”“id”5735776“名称”“123”产业},“项目”“id”14808188“名称”“工作组”},“任务”“id”8083366“名称”“编程”},“user_assignment”“id”130403296“is_project_manager”真正的“is_active”真正的“预算”“created_at”“2017 - 08 - 22 - t17:36:54z”“updated_at”“2017 - 08 - 22 - t17:36:54z”“hourly_rate”One hundred.},“task_assignment”“id”160726645“计费”真正的“is_active”真正的“created_at”“2017 - 08 - 22 - t17:36:54z”“updated_at”“2017 - 08 - 22 - t17:36:54z”“hourly_rate”One hundred.“预算”},“小时”0.02“hours_without_timer”0.02“rounded_hours”0.25“笔记”“created_at”“2017 - 08 - 22 - t17:37:13z”“updated_at”“2017 - 08 - 22 - t17:38:31z”“is_locked”“locked_reason”“is_closed”“is_billed”“timer_started_at”“started_time”“11:37am”“ended_time”“11:38am”“is_running”“发票”“external_reference”“计费”真正的“预算”“billable_rate”One hundred.“cost_rate”75

还有问题吗?我们很乐意帮忙!

联系我们
Baidu
map