GET /apps/{appId}/power-performance-metricsCopy
Proposed · Extended read design · Adapter not implemented
Request Routes are relative to your connection. Use a facade API key; the service manages Apple authentication.
cURL JavaScript Python
cURL Copy
BASE='https://asc.example.com/v1/connections/conn_example'
curl --fail-with-body "$BASE/apps/1234567890/power-performance-metrics" \
-H "Authorization: Bearer $ASC_FACADE_KEY"JavaScript Copy
const base = "https://asc.example.com/v1/connections/conn_example";
const response = await fetch(`${base}/apps/1234567890/power-performance-metrics`, {
headers: { Authorization: `Bearer ${process.env.ASC_FACADE_KEY}` }
});
const body = await response.json();
if (!response.ok) {
throw new Error(body.error?.message ?? `HTTP ${response.status}`);
}
console.log(body);Python Copy
import json
import os
from urllib.request import Request, urlopen
from urllib.error import HTTPError
base = "https://asc.example.com/v1/connections/conn_example"
request = Request(
f"{base}/apps/1234567890/power-performance-metrics",
headers={"Authorization": f"Bearer {os.environ['ASC_FACADE_KEY']}"},
)
try:
with urlopen(request) as response:
print(json.load(response))
except HTTPError as error:
detail = json.load(error)
raise RuntimeError(detail["error"]["message"]) from errorasc.example.com is a placeholder for your deployment. Examples use fictional IDs.
Path parameters Name Type Description appId Required stringApple’s app ID. Returned by List apps.
Query parameters Name Type Description platform Optional stringRestrict results to the specified Apple platforms. Multiple values are comma-separated.Values IOS metricType Optional stringFilter by metric type. Multiple values are comma-separated.Values DISK, HANG, BATTERY, LAUNCH, MEMORY, ANIMATION, TERMINATION, STORAGE deviceType Optional stringFilter by device type. Multiple values are comma-separated.
Response Structured metric data, with series and dimension values preserved.
200 · application/json Copy
{
"version" : "1.0" ,
"insights" : {
"trendingUp" : [
{
"metricCategory" : "HANG" ,
"latestVersion" : "latest_version_example" ,
"metric" : "metric_example" ,
"summaryString" : "summary_string_example" ,
"referenceVersions" : "reference_versions_example" ,
"maxLatestVersionValue" : 1
}
],
"regressions" : [
{
"metricCategory" : "HANG" ,
"latestVersion" : "latest_version_example" ,
"metric" : "metric_example" ,
"summaryString" : "summary_string_example" ,
"referenceVersions" : "reference_versions_example" ,
"maxLatestVersionValue" : 1
}
]
},
"productData" : [
{
"platform" : "platform_example" ,
"metricCategories" : [
{
"identifier" : "HANG" ,
"metrics" : []
}
]
}
]
}Illustrative response. Optional read fields may be absent or null; unknown enum values are preserved.
Response fields Name Type Description version stringThe format version of this metrics response. insights objectApple’s performance findings for this resource. productData object[]Performance series grouped by product, version, and platform.
insights fields Name Type Description trendingUp Optional object[]The trending up value reported by Apple for this resource. regressions Optional object[]The regressions value reported by Apple for this resource.
insights.trendingUp fields Name Type Description metricCategory Optional stringThe metric category value reported by Apple for this resource.Values HANG, LAUNCH, MEMORY, DISK, BATTERY, TERMINATION, ANIMATION, STORAGE latestVersion Optional stringThe latest version value reported by Apple for this resource. metric Optional stringThe metric value reported by Apple for this resource. summaryString Optional stringThe summary string value reported by Apple for this resource. referenceVersions Optional stringThe reference versions value reported by Apple for this resource. maxLatestVersionValue Optional numberThe max latest version value value reported by Apple for this resource. subSystemLabel Optional stringThe sub system label value reported by Apple for this resource. highImpact Optional booleanWhether Apple marks this resource as high impact. populations Optional object[]The populations value reported by Apple for this resource.
insights.trendingUp.populations fields Name Type Description deltaPercentage Optional numberThe delta percentage value reported by Apple for this resource. percentile Optional stringThe percentile value reported by Apple for this resource. summaryString Optional stringThe summary string value reported by Apple for this resource. referenceAverageValue Optional numberThe reference average value value reported by Apple for this resource. latestVersionValue Optional numberThe latest version value value reported by Apple for this resource. device Optional stringThe device value reported by Apple for this resource.
insights.regressions fields Name Type Description metricCategory Optional stringThe metric category value reported by Apple for this resource.Values HANG, LAUNCH, MEMORY, DISK, BATTERY, TERMINATION, ANIMATION, STORAGE latestVersion Optional stringThe latest version value reported by Apple for this resource. metric Optional stringThe metric value reported by Apple for this resource. summaryString Optional stringThe summary string value reported by Apple for this resource. referenceVersions Optional stringThe reference versions value reported by Apple for this resource. maxLatestVersionValue Optional numberThe max latest version value value reported by Apple for this resource. subSystemLabel Optional stringThe sub system label value reported by Apple for this resource. highImpact Optional booleanWhether Apple marks this resource as high impact. populations Optional object[]The populations value reported by Apple for this resource.
insights.regressions.populations fields Name Type Description deltaPercentage Optional numberThe delta percentage value reported by Apple for this resource. percentile Optional stringThe percentile value reported by Apple for this resource. summaryString Optional stringThe summary string value reported by Apple for this resource. referenceAverageValue Optional numberThe reference average value value reported by Apple for this resource. latestVersionValue Optional numberThe latest version value value reported by Apple for this resource. device Optional stringThe device value reported by Apple for this resource.
productData fields Name Type Description platform Optional stringApple’s platform value, preserved without renaming. metricCategories Optional object[]The metric categories value reported by Apple for this resource.
productData.metricCategories fields Name Type Description identifier Optional stringThe identifier value reported by Apple for this resource.Values HANG, LAUNCH, MEMORY, DISK, BATTERY, TERMINATION, ANIMATION, STORAGE metrics Optional object[]The metrics value reported by Apple for this resource.
productData.metricCategories.metrics fields Name Type Description identifier Optional stringThe identifier value reported by Apple for this resource. goalKeys Optional object[]The goal keys value reported by Apple for this resource. unit Optional objectThe unit value reported by Apple for this resource. datasets Optional object[]The datasets value reported by Apple for this resource.
productData.metricCategories.metrics.goalKeys fields Name Type Description goalKey Optional stringThe goal key value reported by Apple for this resource. lowerBound Optional integerThe lower bound value reported by Apple for this resource. upperBound Optional integerThe upper bound value reported by Apple for this resource.
productData.metricCategories.metrics.unit fields Name Type Description identifier Optional stringThe identifier value reported by Apple for this resource. displayName Optional stringThe display name value reported by Apple for this resource.
productData.metricCategories.metrics.datasets fields Name Type Description filterCriteria Optional objectThe filter criteria value reported by Apple for this resource. points Optional object[]The points value reported by Apple for this resource. recommendedMetricGoal Optional objectThe recommended metric goal value reported by Apple for this resource.
Behavior A nested resource must belong to the selected parent and the configured connection. The adapter validates ownership before returning data. Errors HTTP Type Description 400 invalid_queryUnsupported filter, sort, limit, or cursor. 401 unauthorizedMissing or invalid facade API key. 403 forbidden / upstream_forbiddenThe caller or configured Apple key cannot read this resource. 404 resource_not_foundThe requested resource, parent, or exact locale is absent or outside the caller’s scope. 429 rate_limitedA facade or Apple rate limit was reached. Respect Retry-After when returned. 502–504 upstream errorApple authentication, response parsing, availability, or timeout failure; this is not an empty result.
Apple mapping Upstream route and translation The adapter calls GET /v1/apps/{id}/perfPowerMetrics. Read Apple’s original endpoint ↗
Apple returns application/vnd.apple.xcode-metrics+json. The adapter retains the metric-series structure, removes transport envelopes where present, and exposes dimension linkage as IDs.
Facade parameter Type Description platform queryfilter[platform]metricType queryfilter[metricType]deviceType queryfilter[deviceType]
Reviewed 2026-10-14 · OpenAPI 4.5.1