创建和显示项目

项目参数

参数 描述
ID< /代码> 项目ID
客户机id< /代码> 客户机ID为项目
的名字< /代码> 项目名称
代码< /代码> 项目代码
活跃的< /代码> 项目是否活跃或存档。选项:真正的< /代码>,假< /代码>。
计费< /代码> 是否项目计费计费。选项:真正的< /代码>,假< /代码>。
Is-Fixed-Fee< /代码> 是否项目类型是固定的费用。选项:真正的< /代码>,假< /代码>。
费< /代码> 项目总费用。只有现在的固定费用项目。
法案< /代码> 该方法的项目发票。选项:项目< /代码>,任务< /代码>,人< /代码>,或没有一个< /代码>。
每小时工资率< /代码> 每小时工资率率为项目宣传项目
预算< /代码> 项目预算的方法。选项:项目< /代码>(小时/项目),Project_Cost< /代码>(项目总费用),任务< /代码>(小时/任务),人< /代码>(小时/人),没有一个< /代码>(无预算)。
预算< /代码> 预算项目的值。
Notify-When-Over-Budget< /代码> 选择发送通知邮件当项目到达预算阈值集Over-Budget-Notification-Percentage< /代码>选项:真正的< /代码>,假< /代码>。
Over-Budget-Notification-Percentage< /代码> 百分比值触发超过预算的电子邮件警报。
Over-Budget-Notified-At< /代码> 去年超过预算日期通知。如果没有被发送,这将是零< /代码>。
Show-Budget-To-All< /代码> 选择显示所有员工的项目预算。并不适用于项目总费用的项目。选项:真正的< /代码>,假< /代码>。
创建< /代码> 项目创建日期。
更新于< /代码> 项目最后更新日期。
开始于< /代码> 项目的开始日期。
结束< /代码> 项目的结束日期。
Hint-Earliest-Record-At< /代码> 最早的日期记录这个项目。每24小时更新一次。
Hint-Latest-Record-At< /代码> 最近的日期记录这个项目。每24小时更新一次。
笔记< /代码> 项目记录。
成本预算< /代码> 为项目总费用项目预算值。
Cost-Budget-Includes-Expenses< /代码> 选择预算项目总费用项目包括跟踪费用。

显示一个项目

得到https://YOURACCOUNT.bob客服端下载harvestapp.com/projects/ {PROJECTID}< /代码>

HTTP响应:200好了

例子

示例请求邮递员

< ?xml version = " 1.0 " encoding = " utf - 8 " ? ><项目>< id类型=“整数”>3554414< / id ><客户机id类型=“整数”>3398386< /客户机id ><名称>内部< /名称><代码>测试< /代码><活跃类型=“布尔”>真正的< /主动><计费类型=“布尔”>真正的< /计费>< is-fixed-fee类型=“布尔”>真正的< / is-fixed-fee ><费用类型=“小数”>1000.0> < /费用<法案>< /法案><小时率类型=“小数”>100.0< /小时率><预算类型=“小数”>100.0< /预算><预算>项目< /预算>< notify-when-over-budget类型=“布尔”>真正的< / notify-when-over-budget >< over-budget-notification-percentage类型=“小数”>80.0< / over-budget-notification-percentage >< over-budget-notified-atnil =“真正的”/ >< show-budget-to-all类型=“布尔”>真正的< / show-budget-to-all ><创建类型=“dateTime”>2013 - 04 - 30 - t20:28:12z< /创建><更新于类型=“dateTime”>2015 - 04 - 15 - t15:44:17z< /更新于><开始于类型=“日期”>2013-04-30< /开始于><结束类型=“日期”>2015-06-01< /结束><估计类型=“小数”>100.0< /估计><估计>项目< /估计>< hint-earliest-record-at类型=“日期”>2013-04-30< / hint-earliest-record-at >< hint-latest-record-at类型=“日期”>2014-12-09< / hint-latest-record-at ><笔记>一些项目笔记去这里!< /笔记><成本预算nil =“真正的”/ >< cost-budget-include-expenses类型=“布尔”>< / cost-budget-include-expenses >< /项目>
{“项目”:{“id”:3554414,“client_id”:3398386,“名称”:“内部”,“代码”:“测试”,“活跃”:真正的,“计费”:真正的,“is_fixed_fee”:真正的,“费用”:1000年,“bill_by”:“人”,“hourly_rate”:One hundred.,“预算”:One hundred.,“budget_by”:“项目”,“notify_when_over_budget”:真正的,“over_budget_notification_percentage”:80年,“over_budget_notified_at”:,“show_budget_to_all”:真正的,“created_at”:“2013 - 04 - 30 - t20:28:12z”,“updated_at”:“2015 - 04 - 15 - t15:44:17z”,“starts_on”:“2013-04-30”,“ends_on”:“2015-06-01”,“估计”:One hundred.,“estimate_by”:“项目”,“hint_earliest_record_at”:“2013-04-30”,“hint_latest_record_at”:“2014-12-09”,“笔记”:“一些项目笔记去这里!”,“cost_budget”:,“cost_budget_include_expenses”:}}

显示所有项目

得到https://YOURACCOUNT.bob客服端下载harvestapp.com/projects< /代码>

HTTP响应:200好了

例子

示例请求邮递员

< ?xml version = " 1.0 " encoding = " utf - 8 " ? ><项目类型=“数组”><项目>< id类型=“整数”>3554414< / id ><客户机id类型=“整数”>3398386< /客户机id ><名称>内部< /名称><代码>测试< /代码><活跃类型=“布尔”>真正的< /主动><计费类型=“布尔”>真正的< /计费>< is-fixed-fee类型=“布尔”>真正的< / is-fixed-fee ><费用类型=“小数”>1000.0> < /费用<法案>< /法案><小时率类型=“小数”>100.0< /小时率><预算类型=“小数”>100.0< /预算><预算>项目< /预算>< notify-when-over-budget类型=“布尔”>真正的< / notify-when-over-budget >< over-budget-notification-percentage类型=“小数”>80.0< / over-budget-notification-percentage >< over-budget-notified-atnil =“真正的”/ >< show-budget-to-all类型=“布尔”>真正的< / show-budget-to-all ><创建类型=“dateTime”>2013 - 04 - 30 - t20:28:12z< /创建><更新于类型=“dateTime”>2015 - 04 - 15 - t16:26:06z< /更新于><开始于类型=“日期”>2013-04-30< /开始于><结束类型=“日期”>2015-06-01< /结束><估计类型=“小数”>100.0< /估计><估计>项目< /估计>< hint-earliest-record-at类型=“日期”>2013-04-30< / hint-earliest-record-at >< hint-latest-record-at类型=“日期”>2014-12-09< / hint-latest-record-at ><笔记>一些项目笔记去这里!< /笔记><成本预算nil =“真正的”/ >< cost-budget-include-expenses类型=“布尔”>< / cost-budget-include-expenses >< /项目>> < /项目
({“项目”:{“id”:3554414,“client_id”:3398386,“名称”:“内部”,“代码”:“测试”,“活跃”:真正的,“计费”:真正的,“is_fixed_fee”:真正的,“费用”:1000年,“bill_by”:“人”,“hourly_rate”:One hundred.,“预算”:One hundred.,“budget_by”:“项目”,“notify_when_over_budget”:真正的,“over_budget_notification_percentage”:80年,“over_budget_notified_at”:,“show_budget_to_all”:真正的,“created_at”:“2013 - 04 - 30 - t20:28:12z”,“updated_at”:“2015 - 04 - 15 - t16:26:06z”,“starts_on”:“2013-04-30”,“ends_on”:“2015-06-01”,“估计”:One hundred.,“estimate_by”:“项目”,“hint_earliest_record_at”:“2013-04-30”,“hint_latest_record_at”:“2014-12-09”,“笔记”:“一些项目笔记去这里!”,“cost_budget”:,“cost_budget_include_expenses”:}}]

过滤请求

请求可以过滤client_id< /代码>和updated_since< /代码>。例如:

  • 得到https://YOURACCOUNT.bob客服端下载harvestapp.com/projects?client= {CLIENTID}< /代码>

  • 得到故事本来https://YOURACCObob客服端下载UNT.harvestapp.com/projects?updated_since=2015-03-25 + 18% 3< /代码>

这些请求将只返回项目为一个特定的客户端,或项目已经更新自3月25日,2015晚上6:30 UTC,分别。

创建一个新项目

帖子https://YOURACCOUNT.bob客服端下载harvestapp.com/projects< /代码>

创建HTTP响应:201

创建一个新项目,你需要帖子< /代码>以下至少:

参数 描述
的名字< /代码> 项目名称。
活跃的< /代码> 如果项目是活跃的,或存档。选项:真正的< /代码>,假< /代码>。
法案< /代码> 这个项目是如何收费的。选项:项目< /代码>,任务< /代码>,人< /代码>,或没有一个< /代码>。
客户机id< /代码> 一个有效的,现有的客户机ID。

例子

示例请求邮递员

<项目><名称>新项目< /名称><活跃类型=“布尔”>真正的< /主动><客户机id类型=“整数”>3398386< /客户机id >< /项目>
{“项目”:{“client_id”:3398386,“名称”:“新项目”,“活跃”:真正的}}

附加的项目功能

更新现有的项目

https://YOURACCOUNT.bob客服端下载harvestapp.com/projects/ {PROJECTID}< /代码>

发布类似的XML或JSON与创建一个新的项目,但是包括客户机id< /代码>作为项目的一部分。激活一个项目需要使用一个单独的方法。

(反)激活现有的项目

https://YOURACCOUNT.bob客服端下载harvestapp.com/projects/ {PROJECTID} /切换< /代码>

注意:如果你的帐户是免费计划,到达两个项目限制,收获将返回bob客服端下载HTTP响应:400错误请求< /代码>,提示头。

删除一个项目

删除https://YOURACCOUNT.bob客服端下载harvestapp.com/projects/ {PROJECTID}< /代码>

如果项目没有任何时间表跟踪的数据,它被删除HTTP响应:200好了< /代码>。如果项目确实有时间表条目相关联,项目不是删除HTTP响应:400错误请求< /代码>返回。

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

联系我们
Baidu
map