You need to enable JavaScript to run this app.
导航
GetAppFieldValues
最近更新时间:2024.07.15 16:31:28首次发布时间:2023.03.13 16:59:23

获取App筛选条件的可选取值。

请求说明

  • 请求方式:POST
  • 请求地址:https://open.volcengineapi.com?Action=GetAppFieldValues&Version=2022-10-12
ServiceName: apmplus_openapi
Region: cn-beijing
X-App-Ids: xxx
Content-Type: application/json

请求参数

Query

参数类型是否必选示例值描述
ActionStringGetAppFieldValues接口名称。当前 API 的名称为 GetAppFieldValues
VersionString2022-10-12接口版本。当前 API 的版本为 2022-10-12

Body

参数类型是否必选示例值描述
aidInteger123456应用ID。
start_timeInteger1665417600开始时间。
end_timeInteger1665504000终止时间。

biz_type

String

crash

异常类型。

  • crash:崩溃
  • crash_defend:崩溃防护
  • lag:卡顿
  • custom_exception:自定义异常
keywordString-搜索关键字。

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页面
limitInteger100返回数据量,默认按上报量倒序排列。
filtersObject of Condition-筛选条件,可以指定多个键值对来筛选数据。

time_type

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:当前condition是一个表达式。
  • and:当前condition是一个复合表达式,多个sub_condition的逻辑关系是and。
  • or:当前condition是一个复合表达式,多个sub_condition的逻辑关系是or。
  • map:当前condition是map类型。
valueStringAndroid筛选值。
valuesArray of String["Android"]筛选值,支持多个。
map_keyStringkey_1map类型key,当type为map时必填。
dimensionStringaid条件的名称。
sub_conditionsArray of Condition-子条件。

返回参数

参数类型示例值描述
dataArray of RangeItem-返回数据。
error_msgString-错误信息。
error_noInteger0错误码。

RangeItem

参数类型示例值描述
labelString9.9.7字段值显示名称。
valueString9.9.7字段值。

请求示例

POST https://open.volcengineapi.com?Action=GetAppFieldValues&Version=2022-10-12
{
    "aid":123456,
    "start_time":1678586400,
    "end_time":1678674164,
    "field":"app_version",
    "keyword":"",
    "limit":100,
    "filters":{
        "type":"and",
        "sub_conditions":[
            {
                "dimension":"os",
                "op":"in",
                "type":"expression",
                "values":[
                    "Android"
                ]
            }
        ]
    },
    "biz_type":"crash"
}

返回示例

{
    "err_detail":"",
    "data":[
        {
            "value":"9.9.7",
            "label":"9.9.7"
        },
        {
            "value":"9.9.6",
            "label":"9.9.6"
        },
        {
            "value":"1.1.5",
            "label":"1.1.5"
        },
        {
            "value":"1.1.7",
            "label":"1.1.7"
        },
        {
            "value":"3.1.6-alpha.222",
            "label":"3.1.6-alpha.222"
        },
        {
            "value":"9.9.9",
            "label":"9.9.9"
        },
        {
            "value":"3.1.6-alpha.184",
            "label":"3.1.6-alpha.184"
        },
        {
            "value":"8.9.0",
            "label":"8.9.0"
        }
    ],
    "error_msg":"",
    "error_no":0
}

错误码

本接口无特有的错误码。更多信息请参见错误码