cube.js 同时提供了强大的rest api 支持,默认请求地址是/cubejs-api
,当然可以通过Cube.js 修改
认证授权
cube.js api 的认证授权是基于jwt 的,同时会暴露一个USER_CONTEXT
对象给数据schema
参考请求
curl -H "Authorization: EXAMPLE-API-TOKEN" https://example.com/cubejs-api/v1/sql
超长请求处理
cube.js 对于超长查询处理的,会返回一个{ "error": "Continue wait" }
状态码为200 的响应,我们可以基于此进行重试
提供的api
- /v1/load
提供了数据查询的处理
参考
curl \
-X POST
-H "Content-Type: application/json" \
-H "Authorization: EXAMPLE-API-TOKEN" \
-G \
--data ‘{"query": {"measures":["Users.count"]}}‘ \
http://localhost:4000/cubejs-api/v1/load
- /v1/sql
提供sql生成的获取
参考
curl \
-H "Authorization: EXAMPLE-API-TOKEN" \
-G \
--data-urlencode ‘query={"measures":["Users.count"],
"timeDimensions":[{"dimension": "Users.createdAt","granularity":"day","dateRange":["2019-03-01","2019-03-31"]}]}‘ \
http://localhost:4000/cubejs-api/v1/sql
- /v1/meta
提供数据schema 元数据的api - /v1/run-scheduled-refresh
提供数据预聚合刷新的处理