联系我们费用类别
需要管理权限。
费用类别对象
| 属性 | 类型 | 描述 |
|---|---|---|
id |
整数 | 费用类别的唯一ID。 |
的名字 |
字符串 | 费用类别的名称。 |
unit_name |
字符串 | 费用类别的单位名称。 |
unit_price |
小数 | 费用类别的单价。 |
is_active |
布尔 | 费用类别是活动的还是存档的。 |
created_at |
datetime | 创建费用类别的日期和时间。 |
updated_at |
datetime | 费用类别最后更新的日期和时间。 |
列出所有费用类别
返回费用类别的列表。费用类别按创建日期排序返回，最近创建的费用类别出现在前面。
响应包含一个对象expense_categories属性，该属性包含最多到的数组per_page费用类别。数组中的每个条目都是一个单独的费用类别对象。如果没有更多可用的费用类别，则结果数组将为空。响应中还包括几个额外的分页属性，以简化对费用类别的分页。
获得/ v2 / expense_categories| 参数 | 类型 | 描述 |
|---|---|---|
is_active |
布尔 | 通过真正的仅返回活动费用类别和假返回不活跃的费用类别。 |
updated_since |
datetime | 只返回自给定日期和时间以来更新过的费用类别。 |
页面 |
整数 | 在分页中使用的页码。例如，如果您提出一个列表请求并收到2000条记录，您的后续呼叫可以包括页面= 2检索列表的下一页。(默认值:1) |
per_page |
整数 | 每页要返回的记录数。取值范围为1 ~ 2000。(默认:2000) |
示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/expense_categories" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"示例响应:
｛“expense_categories”：［｛“id”：4197501，“名称”：“住宿”，“unit_name”：零，“unit_price”：零，“is_active”：真正的，“created_at”：“2017 - 06 - 27 t15:01:32z”，“updated_at”：“2017 - 06 - 27 t15:01:32z”}，｛“id”：4195930，“名称”：“里程”，“unit_name”：“英里”，“unit_price”：0.535，“is_active”：真正的，“created_at”：“2017 - 06 - 26 t20:41:00z”，“updated_at”：“2017 - 06 - 26 t20:41:00z”}，｛“id”：4195928，“名称”：“交通”，“unit_name”：零，“unit_price”：零，“is_active”：真正的，“created_at”：“2017 - 06 - 26 t20:41:00z”，“updated_at”：“2017 - 06 - 26 t20:41:00z”}，｛“id”：4195926，“名称”：“吃饭”，“unit_name”：零，“unit_price”：零，“is_active”：真正的，“created_at”：“2017 - 06 - 26 t20:41:00z”，“updated_at”：“2017 - 06 - 26 t20:41:00z”｝]，“per_page”：2000，“total_pages”：1，“total_entries”：4，“next_page”：零，“previous_page”：零，“页面”：1，“链接”: {“第一”：“https://api.bob客服端下载harvestapp.com/v2/expense_categories?page=1&per_page=2000”，“下一个”：零，“以前”：零，“最后一次”：“https://api.bob客服端下载harvestapp.com/v2/expense_categories?page=1&per_page=2000”｝｝检索费用类别
检索具有给定ID的费用类别。返回一个费用类别对象和200好了提供有效标识符时的响应代码。
GET / v2 / expense_categories / {EXPENSE_CATEGORY_ID}示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/expense_categories/4197501" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"示例响应:
｛“id”：4197501，“名称”：“住宿”，“unit_name”：零，“unit_price”：零，“is_active”：真正的，“created_at”：“2017 - 06 - 27 t15:01:32z”，“updated_at”：“2017 - 06 - 27 t15:01:32z”｝创建一个费用类别
创建一个新的费用类别对象。返回一个费用类别对象和201年创建调用成功时的响应代码。
POST / v2 / expense_categories| 参数 | 类型 | 要求 | 描述 |
|---|---|---|---|
的名字 |
字符串 | 要求 | 费用类别的名称。 |
unit_name |
字符串 | 可选 | 费用类别的单位名称。 |
unit_price |
小数 | 可选 | 费用类别的单价。 |
is_active |
布尔 | 可选 | 费用类别是活动的还是存档的。默认为真正的． |
示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/expense_categories" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"\ -X POST \ -H "Content-Type: application/json" \ -d '{"name":"其他"}'示例响应:
｛“id”：4197514，“名称”：“其他”，“unit_name”：零，“unit_price”：零，“is_active”：真正的，“created_at”：“2017 - 06 - 27 t15:04:23z”，“updated_at”：“2017 - 06 - 27 t15:04:23z”｝更新费用类别
通过设置传递的参数值更新特定的费用类别。任何未提供的参数将保持不变。返回一个费用类别对象和200好了调用成功时的响应代码。
补丁/ v2 / expense_categories / {EXPENSE_CATEGORY_ID}| 参数 | 类型 | 描述 |
|---|---|---|
的名字 |
字符串 | 费用类别的名称。 |
unit_name |
字符串 | 费用类别的单位名称。 |
unit_price |
小数 | 费用类别的单价。 |
is_active |
布尔 | 费用类别是活动的还是存档的。 |
示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/expense_categories/4197514" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"\ -X PATCH \ -H "Content-Type: application/json" \ -d '{"is_active":false}'示例响应:
｛“id”：4197514，“名称”：“其他”，“unit_name”：零，“unit_price”：零，“is_active”：假，“created_at”：“2017 - 06 - 27 t15:04:23z”，“updated_at”：“2017 - 06 - 27 t15:04:58z”｝删除费用类别
删除费用类别。返回一个200好了调用成功时的响应代码。
删除/ v2 / expense_categories / {EXPENSE_CATEGORY_ID}示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/expense_categories/4197514" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"\ -x删除