项目用户作业
用户分配对象
属性 | 类型 | 描述 |
---|---|---|
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