Parsequerade / docs
App Custom Product Page Localizations
GET/custom-product-page-versions/{pageVersionId}/localizations/{locale}/preview-sets/ids

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
BASE='https://asc.example.com/v1/connections/conn_example'

curl --fail-with-body "$BASE/custom-product-page-versions/page_version_123/localizations/en-US/preview-sets/ids" \
  -H "Authorization: Bearer $ASC_FACADE_KEY"

asc.example.com is a placeholder for your deployment. Examples use fictional IDs.

Path parameters

NameTypeDescription
pageVersionIdRequiredstringThe selected resource’s ID.
localeRequiredstringThe exact locale to read. No fallback to a different locale.

Query parameters

NameTypeDescription
limitOptional · Default 50integerNumber of items per page, from 1 to 200.
cursorOptionalstringOpaque nextCursor from a previous response. Keep the route, connection, filters, and ordering unchanged.

Response

A page of plain resource IDs, with an opaque continuation cursor.

200 · application/json
{
  "items": [
    "preview_set_123"
  ],
  "nextCursor": null
}

Illustrative response. Optional read fields may be absent or null; unknown enum values are preserved.

Response fields

NameTypeDescription
itemsstring[]The current page of IDs.
nextCursorstring | nullOpaque continuation token, or null when the collection is complete. Pass it back as cursor.

Behavior

  • Resolve the exact locale within the selected parent, validate ownership, and read the resolved localization. No match returns localization_not_found; multiple matches return ambiguous_selection. GET does not create a locale or substitute another language.

Pagination

Pass nextCursor back as cursor with the same filters and ordering. Stop when it is null. Each request returns one bounded page; the service never reports a capped or incomplete traversal as a complete collection.

Errors

HTTPTypeDescription
400invalid_queryUnsupported filter, sort, limit, or cursor.
401unauthorizedMissing or invalid facade API key.
403forbidden / upstream_forbiddenThe caller or configured Apple key cannot read this resource.
404localization_not_foundThe requested resource, parent, or exact locale is absent or outside the caller’s scope.
409ambiguous_selectionMore than one localization matches the selected parent and locale.
429rate_limitedA facade or Apple rate limit was reached. Respect Retry-After when returned.
502–504upstream 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/appCustomProductPageLocalizations/{id}/relationships/appPreviewSets. Read Apple’s original endpoint ↗

Resolve the parent’s localization collection using the exact locale, validate ownership, and then supply the resolved ID to this Apple endpoint.

Keep the related ID values and remove Apple’s resource-type objects. Collections use the facade cursor rather than an upstream pagination URL.

Facade parameterTypeDescription
limitquerylimit
cursorqueryFacade-owned pagination

Reviewed 2026-10-14 · OpenAPI 4.5.1