You need to enable JavaScript to run this app.
Application Performance Management Plus

Application Performance Management Plus

Copy page
Download PDF
Exceptions and crashes
GetAppFieldValues
Copy page
Download PDF
GetAppFieldValues
Obtain the available values for app filter conditions.​
Request description​
RUM is deployed across multiple regions worldwide to provide more stable and low-latency access. You can refer to the Service addresses topic to choose the most suitable access point based on your business location.​
  • Request method: POST​
  • Request URL: https://apmplus-openapi.cn-beijing.volcengineapi.com?Action=GetAppFieldValues&Version=2025-12-01​
Request parameters​
The following table lists only the request parameters specific to this API and some public parameters. For details, see Public parameters.​
tip​
Before you call this API, specify the required public request parameters (such as x-app-ids). Otherwise, the call fails.​
​
Parameters​
Type​
Required​
Sample value​
Description​
Action​
String​
Yes​
GetAppFieldValues​
The API name. The API name is GetAppFieldValues.​
Version​
String​
Yes​
2025-12-01​
The API version. The API version is 2025-12-01.​
Aid​
Integer​
Yes​
123456​
The app ID.​
StartTime​
Integer​
Yes​
1665417600​
The timestamp of the start time. Unit: seconds.​
EndTime​
Integer​
Yes​
1665504000​
The timestamp of the end time. Unit: seconds.​
BizType​
String​
Yes​
crash​
The exception type. Values:​
  • crash: Crash​
  • crash_defend: Crash protection​
  • lag: Lag​
  • custom_exception: Custom exception​
CrashType​
String​
No​
java​
The crash type. Values:​
  • java: Java crash​
  • launch: Java launch crash​
  • native: Native crash​
  • anr: ANR​
  • crash: Crash​
  • watch_dog: Hang​
  • oom_crash: OOM crash​
  • extension: Extension crash​
Os​
String​
No​
Android​
The operating system. Values:​
  • Android​
  • iOS​
IssueId​
String​
No​
issue_xxx​
The issue ID.​
Keyword​
String​
No​
keyword​
The search keyword.​
Field​
String​
Yes​
os_version​
The field key. Sample value:​
  • os_version: OS version​
  • device_model: Device model​
  • app_version: App version​
  • update_version_code: App minor version​
  • npth_version: APM SDK version​
  • channel: Download channel​
  • rom: ROM information​
  • province: Province​
  • process_name: Process name​
  • device_manufacturer: Manufacturer​
  • last_scene: App page​
Limit​
Integer​
Yes​
100​
The number of returned data entries.​
Filters​
Object of Condition​
No​
-​
The filter condition.​
TimeType​
String​
No​
api_time​
The time type. Values:​
  • api_time: Report time (default)​
  • event_time: Occurrence time​
​
Condition​
​
Parameters​
Type​
Required​
Sample value​
Description​
Op​
String​
No​
in​
The operator. Values:​
  • gt: greater than​
  • gte: greater than or equal to​
  • lt: less than​
  • lte: less than or equal to​
  • eq: equal to​
  • neq: not equal to​
  • in: contains​
  • not_in: does not contain​
  • lk: Matches data that fits a specific pattern.​
  • nlk: Excludes data that fits a specific pattern.​
Type​
String​
No​
expression​
The type of the filter condition. Sample value:​
  • expression: The current condition is a single expression.​
  • and: The current condition is a compound expression, and the sub-conditions in SubConditions are in a logical AND relationship.​
  • or: The current condition is a compound expression, and the sub-conditions in SubConditions are in a logical OR relationship.​
  • map: The current condition is of the map type.​
Value​
String​
No​
123456​
The filter value.​
MapKey​
String​
No​
key_1​
The key of the map type.​
tip​
This parameter is required when type is set to map.​
Values​
Array of String​
No​
[123456]​
The filter values. You can configure multiple values simultaneously.​
Dimension​
String​
No​
aid​
The name of the condition.​
SubConditions​
Array of Condition​
No​
-​
The sub-condition.​
​
Sample request​
​
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"​
}
​
Response parameters​
​
Parameters​
Type​
Sample value​
Description​
Label​
String​
iOS 13​
The display name of the field value.​
Value​
String​
13.0​
The field value.​
​
Sample response​
​
{​
"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"​
} ]​
}
​
Error codes​
No error codes are specific to this API. If the API call returns an error code, refer to Public error codes for troubleshooting.​
Last updated: 2026.09.16 17:53:17