评估项目类别
需要管理权限。
评估项目类别对象
属性 | 类型 | 描述 |
---|---|---|
id |
整数 | 评估项目类别的唯一ID。 |
的名字 |
字符串 | 评估项目类别的名称。 |
created_at |
datetime | 创建评估项目类别的日期和时间。 |
updated_at |
datetime | 上次更新评估项目类别的日期和时间。 |
列出所有评估项目类别
返回估算项目类别的列表。评估项目类别按创建日期排序返回,最近创建的评估项目类别出现在前面。
响应包含一个对象estimate_item_categories
属性,该属性包含最多到的数组per_page
估计项目类别。数组中的每个条目都是一个单独的估计项目类别对象。如果没有更多可用的评估项目类别,则结果数组将为空。响应中包含了几个额外的分页属性,以简化对评估项目类别的分页。
获得/ v2 / estimate_item_categories
参数 | 类型 | 描述 |
---|---|---|
updated_since |
datetime | 只返回自给定日期和时间以来更新过的估计项目类别。 |
页面 |
整数 | 在分页中使用的页码。例如,如果您提出一个列表请求并收到2000条记录,您的后续呼叫可以包括页面= 2 检索列表的下一页。(默认值:1) |
per_page |
整数 | 每页要返回的记录数。取值范围为1 ~ 2000。(默认:2000) |
示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/estimate_item_categories" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"
示例响应:
检索一个评估项目类别
检索具有给定ID的估计项类别。返回估计项类别对象和200好了
提供有效标识符时的响应代码。
GET / v2 / estimate_item_categories / {ESTIMATE_ITEM_CATEGORY_ID}
示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/estimate_item_categories/1378704" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"
示例响应:
创建一个评估项目类别
创建一个新的评估项目类别对象。返回估计项类别对象和201年创建
调用成功时的响应代码。
POST / v2 / estimate_item_categories
参数 | 类型 | 要求 | 描述 |
---|---|---|---|
的名字 |
字符串 | 要求 | 评估项目类别的名称。 |
示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/estimate_item_categories" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"\ -X POST \ -H "Content-Type: application/json" \ -d '{"name":"Hosting"}'
示例响应:
更新评估项目类别
通过设置传递参数的值更新特定的评估项目类别。任何未提供的参数将保持不变。返回估计项类别对象和200好了
调用成功时的响应代码。
补丁/ v2 / estimate_item_categories / {ESTIMATE_ITEM_CATEGORY_ID}
参数 | 类型 | 描述 |
---|---|---|
的名字 |
字符串 | 评估项目类别的名称。 |
示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/estimate_item_categories/1379244" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"\ -X PATCH \ -H "Content-Type: application/json" \ -d '{"name":"Transportation"}'
示例响应:
删除评估项目类别
删除评估项目类别。返回一个200好了
调用成功时的响应代码。
删除/ v2 / estimate_item_categories / {ESTIMATE_ITEM_CATEGORY_ID}
示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/estimate_item_categories/1379244" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"\ -x删除