文档中心/ 百度搭子/ 企业版使用指南/ API参考/ 会话管理/ 查询会话资源点消耗

查询会话资源点消耗

GET
https://api.dumate.cn/api/v1/sessions/{sessionId}/resource-points​

查询指定会话(Session)在时间范围内消耗的资源点总量。不传时间范围时,查询该会话的累计消耗。

时间范围为左闭右开区间 [startAt, endAt)。startAt、endAt 必须为非负整数;同时传入时,需满足 startAt < endAt。指定范围内无资源点消耗时,consumedPoints 为 "0.00"。

权限说明

使用 API Key 鉴权调用 API 流程,具体调用流程,请查看认证鉴权。

请求参数

Headers 参数
除公共头域外,无其它特殊头域
URL 参数
sessionId string

待查询的 Session 标识。

必选
Query 参数
startAt integer

统计起始时间,Unix 秒时间戳;不传表示不限起始时间。

可选
endAt integer

统计截止时间,Unix 秒时间戳;不传表示不限截止时间。

可选
请求结构
GET /api/v1/sessions/ses_demo_a18d0f/resource-points?startAt=1788192000&endAt=1788278400 HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

示例代码

curl
curl --get "https://api.dumate.cn/api/v1/sessions/ses_demo_a18d0f/resource-points" \
--header 'Authorization: Bearer ******' \
--data-urlencode 'startAt=1788192000' \
--data-urlencode 'endAt=1788278400'
curl --get "https://api.dumate.cn/api/v1/sessions/ses_demo_a18d0f/resource-points" \
--header 'Authorization: Bearer ******'

返回响应

Headers 参数
除公共头域外,无其它特殊头域
返回参数
sessionId string

待查询的 Session 标识。

必选
startAt integer

回显请求传入的统计起始时间;未传时不返回。

可选
endAt integer

回显请求传入的统计截止时间;未传时不返回。

可选
consumedPoints string

资源点总量,保留两位小数;无消耗时为 "0.00"。

必选
JSON
{
  "sessionId": "ses_demo_a18d0f",
  "startAt": 1788192000,
  "endAt": 1788278400,
  "consumedPoints": "128.50"
}
JSON
{
  "sessionId": "ses_demo_a18d0f",
  "consumedPoints": "0.00"
}