联系我们用户计费费率
计费费率对象
| 属性 | 类型 | 描述 |
|---|---|---|
id |
整数 | 计费费率的唯一ID。 |
量 |
小数 | 可计费费率的金额。 |
start_date |
日期 | 计费费率生效的日期。 |
end_date |
日期 | 计费费率不再有效的日期。此日期由Harvest计算。bob客服端下载 |
created_at |
datetime | 创建计费费率的日期和时间。 |
updated_at |
datetime | 上一次更新计费费率的日期和时间。 |
需要的权限
您必须是具有编辑计费费率权限的管理员或管理员，才能与/ / {USER_ID} / billable_rates v2 /用户端点。权限不足将导致403年被禁止的状态码。
列出特定用户的所有计费费率
返回标识的用户的计费费率列表USER_ID．可计费费率按顺序返回start_date在美国，最古老的起始计费费率最先出现。
响应包含一个对象billable_rates属性，该属性包含最多到的数组per_page计费率。数组中的每个条目都是一个单独的计费费率对象。如果没有更多可用的计费费率，则结果数组将为空。响应中还包括几个额外的分页属性，以简化对计费费率的分页。
GET / v2 /用户/ {USER_ID} / billable_rates| 参数 | 类型 | 描述 |
|---|---|---|
页面 |
整数 | 在分页中使用的页码。例如，如果您提出一个列表请求并收到2000条记录，您的后续呼叫可以包括页面= 2检索列表的下一页。(默认值:1) |
per_page |
整数 | 每页要返回的记录数。取值范围为1 ~ 2000。(默认:2000) |
示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/users/3226125/billable_rates" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"示例响应:
｛“billable_rates”：［｛“id”：1836493,“数量”：8.25,“start_date”：“2019-01-01”,“end_date”：“2019-05-31”,“created_at”：“2020 - 05 - 01 - t13:17:42z”,“updated_at”：“2020 - 05 - 01 - t13:17:50z”}，｛“id”：1836494,“数量”：9.5,“start_date”：“2019-06-01”,“end_date”：“2019-12-31”,“created_at”：“2020 - 05 - 01 - t13:17:50z”,“updated_at”：“2020 - 05 - 01 - t13:18:02z”}，｛“id”：1836495,“数量”：9.5,“start_date”：“2020-01-01”,“end_date”：“2020-04-30”,“created_at”：“2020 - 05 - 01 - t13:18:02z”,“updated_at”：“2020 - 05 - 01 - t13:18:10z”}，｛“id”：1836496,“数量”：15.0,“start_date”：“2020-05-01”,“end_date”：零,“created_at”：“2020 - 05 - 01 - t13:18:10z”,“updated_at”：“2020 - 05 - 01 - t13:18:10z”｝),“per_page”：2000,“total_pages”：1,“total_entries”：4,“next_page”：零,“previous_page”：零,“页面”：1,“链接”：｛“第一”：“https://api.bob客服端下载harvestapp.com/v2/users/3226125/billable_rates?page=1&per_page=2000”,“下一个”：零,“以前”：零,“最后一次”：“https://api.bob客服端下载harvestapp.com/v2/users/3226125/billable_rates?page=1&per_page=2000”｝｝检索计费费率
检索具有给定ID的计费费率。返回一个计费费率对象和200好了提供有效标识符时的响应代码。
GET / v2 /用户/ {USER_ID} / billable_rates / {billable_RATE_ID}示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/users/3226125/billable_rates/1836493" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"示例响应:
｛“id”：1836493,“数量”：8.25,“start_date”：“2019-01-01”,“end_date”：“2019-05-31”,“created_at”：“2020 - 05 - 01 - t13:17:42z”,“updated_at”：“2020 - 05 - 01 - t13:17:50z”｝创建计费费率
创建一个新的计费费率对象。返回一个计费费率对象和201年创建调用成功时的响应代码。
- 创建一个计费费率没有
start_date将替换用户现有的费率。 - 创建可计费费率
start_date这是在用户现有的费率将这些计费费率替换为新的费率之前。
POST / v2 /用户/ {USER_ID} / billable_rates| 参数 | 类型 | 要求 | 描述 |
|---|---|---|---|
量 |
小数 | 要求 | 可计费费率的金额。 |
start_date |
日期 | 可选 | 计费费率生效的日期。不可能是将来的日期。 |
示例请求:
curl "https://api.bob客服端下载harvestapp.com/v2/users/3226125/billable_rates" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"\ -X POST \ -H "Content-Type: application/json" \ -d '{"amount":5.0，"start_date":"2020-05-05"}'示例响应:
｛“id”：1836555,“数量”：5．0,“start_date”：2020-05-01,“end_date”：零,“created_at”：“2020 - 05 - 01 - t15:04:20z”,“updated_at”：“2020 - 05 - 01 - t15:04:20z”｝