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