iApp

URL Scheme Reference URL Scheme 深度链接文档 URL Scheme 深度連結文件

iApp supports iapp:// (primary) and iappstore:// (legacy alias) URL schemes. External links open app details or the Rankings tab with filters — used by Home Screen widgets, Safari, and Apple Shortcuts via onOpenURL.

Note: Home Screen Quick Actions (long-press the app icon) reuse iapp:// type strings but are delivered through UIApplicationShortcutItem, not onOpenURL. Only app and rank hosts are handled as universal deep links.

Protocol Specification

iapp://<host>?<query>
iappstore://<host>?<query>
Rule Detail
Schemes iapp (primary) · iappstore (legacy, equivalent)
External deep-link hosts app · rank
Query values Must match the app’s Chinese display names for rankings, categories, and regions (same strings shown in the in-app pickers)
Widget taps App rows → app host; widget title / blank area → rank host

Open App Detail

Opens a full-screen detail view for the given App ID.

iapp://app?id={APP_ID}&region={region}&country={cc}
iappstore://app?id={APP_ID}&region={region}&country={cc}
Parameter Required Description
id Yes iTunes track ID (App Store ID)
region No Chinese region display name, e.g. 中国 (default: 中国)
country No ISO country code fallback, e.g. cn — mapped to the matching region name

Example

iapp://app?id=6446581591&region=中国&country=cn

Open Rankings with Filters

Switches to the Rankings tab and applies filter preferences.

iapp://rank?type={rank}&category={category}&region={region}
iappstore://rank?type={rank}&category={category}&region={region}
Parameter Required Description
type No Ranking type display name (must match exactly)
category No Category display name (must match exactly)
region No Region display name (must match exactly)

Unrecognized values are ignored; recognized values are persisted to filter preferences.

Ranking types (type)

Value
热门免费榜
热门付费榜
畅销榜
新上架榜
新上架的免费榜
新上架的付费榜
热门免费 iPad 榜
热门付费 iPad 榜
畅销的 iPad 榜

Common categories (category)

Examples include 所有 App, 游戏, 效率, 工具, 摄影与录像, 社交, 教育 — all 26 in-app category names are accepted when spelled exactly as shown in the picker.

Example

iapp://rank?type=热门免费榜&category=游戏&region=中国

Home Screen Quick Actions

Long-press the app icon to trigger these shortcuts. Customize up to 4 in Settings → Home Screen Long Press → Customize Shortcuts.

Type string Action
iapp://search Search tab + focus search field
iapp://rank Rankings tab
iapp://favorites Settings tab → App Favorites
iapp://subscription Subscriptions tab
iapp://feedback Feedback email sheet
iapp://review In-app App Store rating prompt
iapp://settings Settings tab

These shortcut type strings are not routed through the external onOpenURL handler. Opening iapp://search from Safari or Shortcuts as a URL will not trigger the search shortcut — use the in-app Quick Action or navigate manually.

Shortcuts Tips

  • Copy an App Store link from a detail page, or build iapp://app?id={APP_ID} for direct detail access.
  • For filtered rankings bookmarks, copy the exact Chinese names from the in-app pickers.
  • Widget configuration uses the same app and rank URL formats automatically.

Back to overview · FAQ · Privacy

爱应用支持 iapp://（主）与 iappstore://（兼容别名）URL Scheme。外部链接可打开应用详情或带筛选的榜单 Tab——供 主屏小组件、Safari 与快捷指令通过 onOpenURL 调用。

注： 主屏快捷指令（长按图标）虽使用 iapp:// 类型字符串，但通过 UIApplicationShortcutItem 分发，不走 onOpenURL。仅 app 与 rank 两个 host 作为通用深度链接处理。

协议格式

iapp://<host>?<query>
iappstore://<host>?<query>
规则 说明
Scheme iapp（主）· iappstore（兼容，等效）
外部深度链接 host app · rank
查询参数值 须与应用内选择器显示的中文名称完全一致（榜单、分类、地区）
小组件点击 应用行 → app host；标题 / 空白区 → rank host

打开应用详情

以全屏方式打开指定 App ID 的详情页。

iapp://app?id={APP_ID}&region={地区}&country={cc}
参数 必填 说明
id 是 iTunes track ID（App Store ID）
region 否 中文地区名，如 中国（默认 中国）
country 否 ISO 国家代码兜底，如 cn，映射为对应地区名

示例

iapp://app?id=6446581591&region=中国&country=cn

打开榜单并应用筛选

切换至榜单 Tab 并写入筛选条件。

iapp://rank?type={榜单}&category={分类}&region={地区}
参数 必填 说明
type 否 榜单类型中文名（须完全匹配）
category 否 分类中文名（须完全匹配）
region 否 地区中文名（须完全匹配）

无法识别的值会被忽略；可识别的值会持久化到筛选偏好。

榜单类型（type）

热门免费榜 · 热门付费榜 · 畅销榜 · 新上架榜 · 新上架的免费榜 · 新上架的付费榜 · 热门免费 iPad 榜 · 热门付费 iPad 榜 · 畅销的 iPad 榜

示例

iapp://rank?type=热门免费榜&category=游戏&region=中国

主屏快捷指令

长按应用图标触发。在 设置 → 主屏图标长按 → 自定义快捷指令 中最多选 4 项。

类型字符串 行为
iapp://search 搜索 Tab + 聚焦搜索框
iapp://rank 榜单 Tab
iapp://favorites 设置 Tab → App 收藏夹
iapp://subscription 订阅 Tab
iapp://feedback 意见反馈邮件
iapp://review 应用内评分弹窗
iapp://settings 设置 Tab

上述快捷指令类型不经外部 onOpenURL 处理。在 Safari / 快捷指令中以 URL 打开 iapp://search 不会触发搜索快捷方式。

返回概览 · 常见问题 · 隐私政策

愛應用支援 iapp://（主）與 iappstore://（相容別名）URL Scheme。外部連結可開啟應用詳情或帶篩選的榜單 Tab——供 主畫面小工具、Safari 與捷徑透過 onOpenURL 呼叫。

註： 主畫面捷徑（長按圖示）雖使用 iapp:// 類型字串，但透過 UIApplicationShortcutItem 分發，不走 onOpenURL。僅 app 與 rank 兩個 host 作為通用深度連結處理。

協定格式

iapp://<host>?<query>
iappstore://<host>?<query>
規則 說明
Scheme iapp（主）· iappstore（相容，等效）
外部深度連結 host app · rank
查詢參數值 須與應用內選擇器顯示的中文名稱完全一致（榜單、分類、地區）
小工具點擊 應用列 → app host；標題 / 空白區 → rank host

開啟應用詳情

以全螢幕方式開啟指定 App ID 的詳情頁。

iapp://app?id={APP_ID}&region={地區}&country={cc}
參數 必填 說明
id 是 iTunes track ID（App Store ID）
region 否 中文地區名，如 中国（預設 中国）
country 否 ISO 國家代碼兜底，如 cn，對應為地區名

範例

iapp://app?id=6446581591&region=中国&country=cn

開啟榜單並套用篩選

切換至榜單 Tab 並寫入篩選條件。

iapp://rank?type={榜單}&category={分類}&region={地區}
參數 必填 說明
type 否 榜單類型中文名（須完全匹配）
category 否 分類中文名（須完全匹配）
region 否 地區中文名（須完全匹配）

無法識別的值會被忽略；可識別的值會持久化到篩選偏好。

榜單類型（type）

热门免费榜 · 热门付费榜 · 畅销榜 · 新上架榜 · 新上架的免费榜 · 新上架的付费榜 · 热门免费 iPad 榜 · 热门付费 iPad 榜 · 畅销的 iPad 榜

範例

iapp://rank?type=热门免费榜&category=游戏&region=中国

主畫面捷徑

長按應用圖示觸發。在 設定 → 主畫面圖示長按 → 自訂捷徑 中最多選 4 項。

類型字串 行為
iapp://search 搜尋 Tab + 聚焦搜尋框
iapp://rank 榜單 Tab
iapp://favorites 設定 Tab → App 收藏夾
iapp://subscription 訂閱 Tab
iapp://feedback 意見回饋郵件
iapp://review 應用內評分彈窗
iapp://settings 設定 Tab

上述捷徑類型不經外部 onOpenURL 處理。在 Safari / 捷徑中以 URL 開啟 iapp://search 不會觸發搜尋捷徑。

返回概覽 · 常見問題 · 隱私政策