电子邮件联系我们
  1. bob客服端下载收获API V2文档
  2. 项目的API
  3. 项目用户作业

项目用户作业

用户分配对象

属性 类型 描述
id 整数 惟一的ID为用户任务。
项目 对象 一个对象包含id、名称和代码的相关项目。
用户 对象 一个对象包含id和相关的用户的名称。
is_active 布尔 是否用户的任务是积极或存档。
is_project_manager 布尔 决定了如果用户项目经理为项目权限。
use_default_rates 布尔 确定哪些计费率(s)将使用在这个用户的项目bill_by是人。当真正的,该项目将使用默认用户的计费率。当假,该项目将使用自定义定义在这个用户分配率。
hourly_rate 小数 自定义项目时使用bill_by是人和use_default_rates是假。
预算 小数 预算项目时使用budget_by是人。
created_at datetime 用户任务是创建日期和时间。
updated_at datetime 最后一次更新用户作业的日期和时间。

需要的权限

你必须与指定的队友或管理员或经理管理项目为了相互作用/ v2 / user_assignments端点。权限不足将导致403年被禁止的状态码。

列出所有用户作业

返回一个项目列表用户作业,积极并存档。用户返回作业按创建日期排序,与最近创建的用户作业首先出现。

响应包含一个对象user_assignments属性包含一个数组per_page用户任务。数组中的每一项都是一个单独的用户分配对象。如果没有更多的可用用户作业,结果数组将是空的。几个额外的分页属性包含在响应简化方法用户作业。

获得/ v2 / user_assignments
参数 类型 描述
user_id 整数 只返回与给定的用户作业属于用户ID。
is_active 布尔 通过真正的只返回活跃用户作业和假返回不活跃的用户作业。
updated_since datetime 只返回用户作业以来更新给定的日期和时间。
页面 整数 使用分页的页号。例如,如果您列出请求和收到2000条记录,后续调用可以包括页面= 2检索列表的下一个页面。(默认值:1)
per_page 整数 每个页面返回的记录数量。介于1和2000之间。(默认:2000)

示例请求:

旋度" https://api.habob客服端下载rvestapp.com/v2/user_assignments " \ - h“授权:无记名ACCESS_TOKEN美元”\ - h”Harvest-Account-Id: $ ACCOUNT_ID \ - h“用户代理:MyApp (yourname@example.com)”

示例响应:

{“user_assignments”:【{“id”:130403297,“is_project_manager”:真正的,“is_active”:真正的,“use_default_rates”:假,“预算”:零,“created_at”:“2017 - 08 - 22 - t17:36:54z”,“updated_at”:“2017 - 08 - 22 - t17:36:54z”,“hourly_rate”:100.0,“项目”:{“id”:14808188,“名称”:“工作组”,“代码”:“助教”},“用户”:{“id”:1782959,“名称”:“金艾伦”}},{“id”:130403296,“is_project_manager”:真正的,“is_active”:真正的,“use_default_rates”:真正的,“预算”:零,“created_at”:“2017 - 08 - 22 - t17:36:54z”,“updated_at”:“2017 - 08 - 22 - t17:36:54z”,“hourly_rate”:100.0,“项目”:{“id”:14808188,“名称”:“工作组”,“代码”:“助教”},“用户”:{“id”:1795925,“名称”:“杰森露”}},{“id”:125068554,“is_project_manager”:真正的,“is_active”:真正的,“use_default_rates”:真正的,“预算”:零,“created_at”:“2017 - 06 - 26 t22:32:52z”,“updated_at”:“2017 - 06 - 26 t22:32:52z”,“hourly_rate”:100.0,“项目”:{“id”:14308069,“名称”:“在线商店——第一阶段”,“代码”:“OS1”},“用户”:{“id”:1782959,“名称”:“金艾伦”}},{“id”:125068553,“is_project_manager”:真正的,“is_active”:真正的,“use_default_rates”:真正的,“预算”:零,“created_at”:“2017 - 06 - 26 t22:32:52z”,“updated_at”:“2017 - 06 - 26 t22:32:52z”,“hourly_rate”:100.0,“项目”:{“id”:14307913,“名称”:“营销网站”,“代码”:“瓦”},“用户”:{“id”:1782959,“名称”:“金艾伦”}},{“id”:125066109,“is_project_manager”:真正的,“is_active”:真正的,“use_default_rates”:假,“预算”:零,“created_at”:“2017 - 06 - 26 t21:52:18z”,“updated_at”:“2017 - 06 - 26 t21:52:18z”,“hourly_rate”:100.0,“项目”:{“id”:14308069,“名称”:“在线商店——第一阶段”,“代码”:“OS1”},“用户”:{“id”:1782884,“名称”:“杰里米Israelsen”}},{“id”:125063975,“is_project_manager”:真正的,“is_active”:真正的,“use_default_rates”:真正的,“预算”:零,“created_at”:“2017 - 06 - 26 t21:36:23z”,“updated_at”:“2017 - 06 - 26 t21:36:23z”,“hourly_rate”:100.0,“项目”:{“id”:14307913,“名称”:“营销网站”,“代码”:“瓦”},“用户”:{“id”:1782884,“名称”:“杰里米Israelsen”}}),“per_page”:2000年,“total_pages”:1,“total_entries”:6,“next_page”:零,“previous_page”:零,“页面”:1,“链接”:{“第一”:“https://api.bob客服端下载harvestapp.com/v2/user_assignments?page=1&per_page=2000”,“下一个”:零,“以前”:零,“最后一次”:“https://api.bob客服端下载harvestapp.com/v2/user_assignments?page=1&per_page=2000”}}

列出所有用户分配一个特定的项目

返回一个列表的用户作业项目了PROJECT_ID。用户返回作业按创建日期排序,与最近创建的用户作业首先出现。

响应包含一个对象user_assignments属性包含一个数组per_page用户任务。数组中的每一项都是一个单独的用户分配对象。如果没有更多的可用用户作业,结果数组将是空的。几个额外的分页属性包含在响应简化方法用户作业。

GET / v2 /项目/ {PROJECT_ID} / user_assignments
参数 类型 描述
user_id 整数 只返回与给定的用户作业属于用户ID。
is_active 布尔 通过真正的只返回活跃用户作业和假返回不活跃的用户作业。
updated_since datetime 只返回用户作业以来更新给定的日期和时间。
页面 整数 使用分页的页号。例如,如果您列出请求和收到2000条记录,后续调用可以包括页面= 2检索列表的下一个页面。(默认值:1)
per_page 整数 每个页面返回的记录数量。介于1和2000之间。(默认:2000)

示例请求:

旋度" https://api.habob客服端下载rvestapp.com/v2/projects/14308069/user_assignments " \ - h“授权:无记名ACCESS_TOKEN美元”\ - h”Harvest-Account-Id: $ ACCOUNT_ID \ - h“用户代理:MyApp (yourname@example.com)”

示例响应:

{“user_assignments”:【{“id”:125068554,“is_project_manager”:真正的,“is_active”:真正的,“use_default_rates”:真正的,“预算”:零,“created_at”:“2017 - 06 - 26 t22:32:52z”,“updated_at”:“2017 - 06 - 26 t22:32:52z”,“hourly_rate”:100.0,“项目”:{“id”:14308069,“名称”:“在线商店——第一阶段”,“代码”:“OS1”},“用户”:{“id”:1782959,“名称”:“金艾伦”}},{“id”:125066109,“is_project_manager”:真正的,“is_active”:真正的,“use_default_rates”:假,“预算”:零,“created_at”:“2017 - 06 - 26 t21:52:18z”,“updated_at”:“2017 - 06 - 26 t21:52:18z”,“hourly_rate”:100.0,“项目”:{“id”:14308069,“名称”:“在线商店——第一阶段”,“代码”:“OS1”},“用户”:{“id”:1782884,“名称”:“杰里米Israelsen”}}),“per_page”:2000年,“total_pages”:1,“total_entries”:2,“next_page”:零,“previous_page”:零,“页面”:1,“链接”:{“第一”:“https://api.bob客服端下载harvestapp.com/v2/projects/14308069/user_assignments?page=1&per_page=2000”,“下一个”:零,“以前”:零,“最后一次”:“https://api.bob客服端下载harvestapp.com/v2/projects/14308069/user_assignments?page=1&per_page=2000”}}

检索用户的任务

检索用户赋值与给定ID。返回一个用户分配对象和一个200好了响应代码提供了一个有效的标识符。

GET / v2 /项目/ {PROJECT_ID} / user_assignments / {USER_ASSIGNMENT_ID}

示例请求:

旋度" https://api.habob客服端下载rvestapp.com/v2/projects/14308069/user_assignments/125068554 " \ - h“授权:无记名ACCESS_TOKEN美元”\ - h”Harvest-Account-Id: $ ACCOUNT_ID \ - h“用户代理:MyApp (yourname@example.com)”

示例响应:

{“id”:125068554,“is_project_manager”:真正的,“is_active”:真正的,“use_default_rates”:真正的,“预算”:零,“created_at”:“2017 - 06 - 26 t22:32:52z”,“updated_at”:“2017 - 06 - 26 t22:32:52z”,“hourly_rate”:100.0,“项目”:{“id”:14308069,“名称”:“在线商店——第一阶段”,“代码”:“OS1”},“用户”:{“id”:1782959,“名称”:“金艾伦”}}

创建一个用户分配

创建一个新用户分配对象。返回一个对象和一个用户分配201年创建响应代码如果调用成功。

POST / v2 /项目/ {PROJECT_ID} / user_assignments
参数 类型 要求 描述
user_id 整数 要求 用户的ID关联的项目。
is_active 布尔 可选 是否用户的任务是积极或存档。默认为真正的。
is_project_manager 布尔 可选 决定了如果用户项目经理为项目权限。默认为假为用户和普通用户的权限真正的对于那些与项目经理或管理员权限。
use_default_rates 布尔 可选 确定哪些计费率(s)将使用在这个用户的项目bill_by是人。当真正的,该项目将使用默认用户的计费率。当假,该项目将使用自定义定义在这个用户分配率。默认为真正的。
hourly_rate 小数 可选 自定义项目时使用bill_by是人和use_default_rates是假。默认为0。
预算 小数 可选 预算项目时使用budget_by是人。

示例请求:

旋度" https://api.habob客服端下载rvestapp.com/v2/projects/14308069/user_assignments " \ - h“授权:无记名ACCESS_TOKEN美元”\ - h”Harvest-Account-Id: $ ACCOUNT_ID \ - h“用户代理:MyApp (yourname@example.com)”\ -X POST \ -H "Content-Type: application/json" \ -d '{"user_id":1782974,"use_default_rates":false,"hourly_rate":75.50}'

示例响应:

{“id”:125068758,“is_project_manager”:假,“is_active”:真正的,“use_default_rates”:假,“预算”:零,“created_at”:“2017 - 06 - 26 t22:36:01z”,“updated_at”:“2017 - 06 - 26 t22:36:01z”,“hourly_rate”:75.5,“项目”:{“id”:14308069,“名称”:“在线商店——第一阶段”,“代码”:“OS1”},“用户”:{“id”:1782974,“名称”:“吉姆·艾伦”}}

更新用户的任务

更新特定的用户分配通过设置的值传递的参数。没有提供任何参数将保持不变。返回一个对象和一个用户分配200好了响应代码如果调用成功。

补丁/ v2 /项目/ {PROJECT_ID} / user_assignments / {USER_ASSIGNMENT_ID}
参数 类型 描述
is_active 布尔 是否用户的任务是积极或存档。
is_project_manager 布尔 决定了如果用户项目经理为项目权限。
use_default_rates 布尔 确定哪些计费率(s)将使用在这个用户的项目bill_by是人。当真正的,该项目将使用默认用户的计费率。当假,该项目将使用自定义定义在这个用户分配率。
hourly_rate 小数 自定义项目时使用bill_by是人和use_default_rates是假。
预算 小数 预算项目时使用budget_by是人。

示例请求:

旋度" https://api.habob客服端下载rvestapp.com/v2/projects/14308069/user_assignments/125068758 " \ - h“授权:无记名ACCESS_TOKEN美元”\ - h”Harvest-Account-Id: $ ACCOUNT_ID \ - h“用户代理:MyApp (yourname@example.com)”\ -X PATCH \ -H "Content-Type: application/json" \ -d '{"budget":120}'

示例响应:

{“id”:125068758,“is_project_manager”:假,“is_active”:真正的,“use_default_rates”:假,“预算”:120.0,“created_at”:“2017 - 06 - 26 t22:36:01z”,“updated_at”:“2017 - 06 - 26 t22:36:35z”,“hourly_rate”:75.5,“项目”:{“id”:14308069,“名称”:“在线商店——第一阶段”,“代码”:“OS1”},“用户”:{“id”:1782974,“名称”:“吉姆·艾伦”}}

删除一个用户分配

删除一个用户任务。删除一个用户分配仅仅是可能的如果它没有时间条目或与之相关的费用。返回一个200好了响应代码如果调用成功。

删除/ v2 /项目/ {PROJECT_ID} / user_assignments / {USER_ASSIGNMENT_ID}

示例请求:

旋度" https://api.habob客服端下载rvestapp.com/v2/projects/14308069/user_assignments/125068758 " \ - h“授权:无记名ACCESS_TOKEN美元”\ - h”Harvest-Account-Id: $ ACCOUNT_ID \ - h“用户代理:MyApp (yourname@example.com)”\ -X DELETE

仍然有问题吗?我们很乐意帮助!

联系我们
Baidu
map