文档中心

应用性能监控全链路版

请输入

异常和崩溃

GetAppFieldValues

获取 App 筛选条件可选值。

请求说明

客户端监控已在全球多个地域部署服务，旨在为您提供更稳定、低延迟的访问体验。您可以通过查阅服务地址文档，根据业务所在地选择最合适的接入点。

请求方式：POST

请求地址：https://apmplus-openapi.cn-beijing.volcengineapi.com?Action=GetAppFieldValues&Version=2025-12-01

请求参数

下方仅列出该接口特有的请求参数和部分公共参数，更多详细信息参见公共参数。

说明

调用本接口前，请在请求中传入必填的公共请求参数（如 x-app-ids），否则将调用失败。

参数	类型	是否必选	示例值	描述
Action	String	是	GetAppFieldValues	接口名称。当前 API 的名称为 GetAppFieldValues。
Version	String	是	2025-12-01	接口版本。当前 API 的版本为 2025-12-01。
Aid	Integer	是	123456	应用 ID。
StartTime	Integer	是	1665417600	开始时间的时间戳，单位：秒。
EndTime	Integer	是	1665504000	结束时间的时间戳，单位：秒。
BizType	String	是	crash	异常类型。取值： crash：崩溃 crash_defend：崩溃防护 lag：卡顿 custom_exception：自定义异常
CrashType	String	否	java	崩溃类型。取值： java：Java 崩溃 launch：Java 启动崩溃 native：Native 崩溃 anr：ANR crash：崩溃 watch_dog：卡死 oom_crash：OOM 崩溃 extension：Extension 崩溃
Os	String	否	Android	操作系统。取值： Android：安卓 iOS：iOS
IssueId	String	否	issue_xxx	issue ID。
Keyword	String	否	keyword	搜索关键字。
Field	String	是	os_version	字段 key。示例值： os_version：系统版本 device_model：机型 app_version：App 版本 update_version_code：App 小版本 npth_version：APM SDK 版本 channel：下载渠道 rom：ROM 信息 province：省份 process_name：进程名 device_manufacturer：厂商 last_scene：App 页面
Limit	Integer	是	100	返回数据条数。
Filters	Object of Condition	否	-	筛选条件。
TimeType	String	否	api_time	时间类型。取值： api_time：上报时间（默认） event_time：发生时间

Condition

参数	类型	是否必选	示例值	描述
Op	String	否	in	操作符。取值： gt：大于 gte：大于等于 lt：小于 lte：小于等于 eq：等于 neq：不等于 in：包含 not_in：不包含 lk：模糊匹配特定模式的数据 nlk：排除模糊匹配的数据
Type	String	否	expression	筛选条件类型。示例值： expression：当前条件为单一表达式。 and：当前条件为复合表达式，各子条件 SubConditions 之间为逻辑“与”关系。 or：当前条件为复合表达式，各子条件 SubConditions 之间为逻辑“或”关系。 map：当前条件为 map 类型。
Value	String	否	123456	筛选值。
MapKey	String	否	key_1	map 类型的 key。说明当 type取值为 map 时，必须配置此参数。
Values	Array of String	否	[123456]	筛选值，支持同时配置多个。
Dimension	String	否	aid	条件的名称。
SubConditions	Array of Condition	否	-	子条件。

请求示例

POST https://apmplus-openapi.cn-beijing.volcengineapi.com?Action=GetAppFieldValues&Version=2025-12-01​
{​
    "Aid": 123456,​
    "StartTime": 1665417600,​
    "EndTime": 1665504000,​
    "BizType": "crash",​
    "CrashType": "java",​
    "Os": "Android",​
    "IssueId": "issue_xxx",​
    "Keyword": "keyword",​
    "Field": "os_version",​
    "Limit": 100,​
    "Filters": {},​
    "TimeType": "api_time"​
}

返回参数

参数	类型	示例值	描述
Label	String	iOS 13	字段值显示名称。
Value	String	13.0	字段值。

返回示例

{​
    "ResponseMetadata": {​
        "Action": "GetAppFieldValues",​
        "Region": "cn-north-1",​
        "Service": "apmplus_openapi",​
        "Version": "2025-12-01",​
        "RequestId": "20230604110420****100232280022D31"​
    },​
    "Result": [​
        {​
            "Label": "Android",​
            "Value": "android"​
        },​
        {​
            "Label": "iOS",​
            "Value": "ios"​
        },​
        {​
            "Label": "iOS 15",​
            "Value": "15.0"​
        },​
        {​
            "Label": "iOS 16",​
            "Value": "16.0"​
        }    ]​
}

错误码

当前接口暂无独立错误码，若接口调用返回异常，可参考公共错误码进行故障排查。

最近更新时间：2026.08.05 11:25:41

这个页面对您有帮助吗？

有用

无用