const base = "https://asc.example.com/v1/connections/conn_example";
const response = await fetch(`${base}/build-upload-files/build_upload_file_123`, {
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
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}/build-upload-files/build_upload_file_123",
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 error
asc.example.com is a placeholder for your deployment. Examples use fictional IDs.
Path parameters
Name
Type
Description
buildUploadFileIdRequired
string
The selected resource’s ID.
Query parameters
Name
Type
Description
fieldsOptional
string
Comma-separated attribute names to return. This selects read fields and does not expand relationships. Multiple values are comma-separated.ValuesassetDeliveryState, assetToken, assetType, fileName, fileSize, sourceFileChecksums, uploadOperations, uti
Illustrative response. Optional read fields may be absent or null; unknown enum values are preserved.
Response fields
Name
Type
Description
id
string
Apple’s resource ID. Keep this string unchanged when addressing a resource.
assetDeliveryState
object
The delivery state and any processing issues Apple reports for this asset.
assetToken
string
The asset token value reported by Apple for this resource.
assetType
string
The asset type value reported by Apple for this resource.ValuesASSET, ASSET_DESCRIPTION, ASSET_SPI
fileName
string
The uploaded file’s name.
fileSize
integer · int64
The file size in bytes.
sourceFileChecksums
object
The source file checksums value reported by Apple for this resource.
uploadOperations
object[]
Apple’s recorded upload-operation metadata. A GET does not perform these operations.
uti
string
The uti value reported by Apple for this resource.Valuescom.apple.binary-property-list, com.apple.ipa, com.apple.pkg, com.apple.xml-property-list, com.pkware.zip-archive
assetDeliveryState fields
Name
Type
Description
errorsOptional
object[]
The errors value reported by Apple for this resource.
warningsOptional
object[]
The warnings value reported by Apple for this resource.
stateOptional
string
The current state reported by Apple for this resource.ValuesAWAITING_UPLOAD, UPLOAD_COMPLETE, COMPLETE, FAILED
assetDeliveryState.errors fields
Name
Type
Description
codeOptional
string
The code value reported by Apple for this resource.
descriptionOptional
string
The localized store description.
assetDeliveryState.warnings fields
Name
Type
Description
codeOptional
string
The code value reported by Apple for this resource.
descriptionOptional
string
The localized store description.
sourceFileChecksums fields
Name
Type
Description
fileOptional
object
The file value reported by Apple for this resource.
compositeOptional
object
The composite value reported by Apple for this resource.
sourceFileChecksums.file fields
Name
Type
Description
hashOptional
string
The hash value reported by Apple for this resource.
algorithmOptional
string
The algorithm value reported by Apple for this resource.ValuesMD5, SHA_256
sourceFileChecksums.composite fields
Name
Type
Description
hashOptional
string
The hash value reported by Apple for this resource.
algorithmOptional
string
The algorithm value reported by Apple for this resource.ValuesMD5
uploadOperations fields
Name
Type
Description
methodOptional
string
The method value reported by Apple for this resource.
urlOptional
string
The url value reported by Apple for this resource.
lengthOptional
integer · int64
The length value reported by Apple for this resource.
offsetOptional
integer · int64
The offset value reported by Apple for this resource.
requestHeadersOptional
object[]
The request headers value reported by Apple for this resource.
expirationOptional
string · date-time
Expiration, as an RFC 3339 timestamp.
partNumberOptional
integer · int64
The part number value reported by Apple for this resource.
entityTagOptional
string
The entity tag value reported by Apple for this resource.
uploadOperations.requestHeaders fields
Name
Type
Description
nameOptional
string
The resource’s name. An app’s localized name is read from its app-info localization.
valueOptional
string
The value 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_query
Unsupported filter, sort, limit, or cursor.
401
unauthorized
Missing or invalid facade API key.
403
forbidden / upstream_forbidden
The caller or configured Apple key cannot read this resource.
404
resource_not_found
The requested resource, parent, or exact locale is absent or outside the caller’s scope.
429
rate_limited
A facade or Apple rate limit was reached. Respect Retry-After when returned.
502–504
upstream error
Apple authentication, response parsing, availability, or timeout failure; this is not an empty result.
Flatten Apple’s attributes into each resource object. Expose supplied singleton linkage as IDs, with no automatic relationship traversal. Read access does not make these fields writable.