You need to enable JavaScript to run this app.
导航
OpenAPI
最近更新时间:2025.06.04 18:44:00首次发布时间:2025.05.19 11:27:51
我的收藏
有用
有用
无用
无用

使用咨询

OpenAPI的获取分群人数接口的QPS多少,是否有压测数据?

  • 获取指定分群用户列表接口建议不要超过100万条数据。
  • 用流式分群导出接口,支持300w以内的分群查询。建议统一调用,避免并发使用这个接口。

详情请参见获取指定分群的用户列表信息

用分群 OpenAPI获取指定分群的用户列表信息,可以设置分页获取数据吗?

目前没有分页的功能

在使用DSL语句进行数据查询时,beginTime和endTime参数的含义?

beginTime和endTime参数的实际含义取决于所选择的时间粒度。例如,如果时间粒度为“按天”,beginTime和endTime应为日期范围。

使用获取分群数据的OpenAPI时,什么状态的分群数据可以被返回?

如果 "status" 状态为刷新中、错误、超时、分群待计算,可以获取数据,但数据可能不太准确。如果 "status" 状态为错误或超时,获取的是前一天的计算结果。

使用获取分群数据的OpenAPI时,下载用户分群的数据是实时的吗?

openapi下载的用户分群用户列表数据为最新刷新数据。

看板查询功能相关的OpenAPI,是否可以刷新缓存?

不支持,没有参数可以触发刷新缓存,获取的是已经计算好的看板数据。

OpenAPI的download下载的csv文件与页面事件分析下载的csv文件有什么区别?

没有区别,如果查询条件一致的话,那么导出的数据也是一致的。

OpenAPI的javaSDK是否有maven?maven的依赖地址在哪里?

OpenAPI的javaSDK没有放置在maven仓库中,可以在官网文档中获取jar包:调用方式

调用报错

调用分群API接口时返回"code": 400, "message":"用户不在此集团下", "fmt_params": {}

Image
解决方案:确认使用的aksk是否正确,并确保该aksk申请的账号在 对应的用户在集团下且有相应的项目权限

调用用户分析 OpenAPI时出现报错“Expecting value: line 1 column 2 (char 10”

检查body json格式是否正常

  1. body中的key加上双引号
  2. js 可通过JSON.stringify等方法进行转换

查询结果异常

调用OpenAPI获取多维表格数据后,数据不正确?

多维表格的看板不能用openapi查报表的方式去查,因为多维表格的dsl非常复杂,返回的格式也跟事件分析的不一样所以不能用openapi查报表的方式去查询。

调用report api(查询报表信息API)时,事件发生时间参数不生效?

使用report api接口时,如果过滤条件中包含日期范围,则实际查询的日期范围以传入的时间过滤参数为准。
如果出现事件过滤参数不生效,可能是设置的过滤时间粒度和查询时间粒度不一致导致的。例如,设置时间过滤参数period的粒度为月度("granularity": "month") 时,DataFinder会自动补齐当月的数据,如果查询数据时的时间粒度是天级粒度,则可能会由于自动补齐出现数据多于预期。此时您需要将时间过滤粒度改为天粒度("granularity": "day"),与查询时的时间粒度一致才行。

调用“获取自定义导出数据文件清单”API时没有数据返回/提交了导出任务但查询不到文件?

解决方案:

  1. 确认应用是否开通了数据导出功能,如果没有开通,需要先开通后再进行操作。
  2. 确认当前使用的DataFinder环境与接口的环境是否一致,DataFinder区分SaaS-云原生、SaaS-非云原生、私有化等不同环境类型,不同环境的接口不一样,需要确认是否使用了正确环境的接口。
  3. 检查是否提交过包含此次查询日期的任务,如果之前没有提交过相同日期的数据,可能会导致查询不到文件。
  4. 建议使用查询API(/openapi/v1/analysis)进行数据查询,而不是获取文件清单接口。
  5. 确认是否选择了事件查询(query_type)。
  6. 如果查询API返回数据为空,可能是数据导出任务未成功提交或任务被关闭。
  7. 如果数据导出任务未成功提交,可以尝试重新提交任务。

SaaS-云原生-云托管环境中,调用用户分群API查询超过100万的用户ID时异常,提示请求超时:504 Gateway Time-out?

此场景下您需要使用流式接口进行查询,详情请参见下载指定分群用户列表信息 (流式)