npx skills add https://github.com/superwall/skills --skill superwall在 {baseDir}/scripts/sw-api.sh 处提供了一个 bash 辅助脚本。它封装了 Superwall REST API V2。
要求:设置 SUPERWALL_API_KEY 环境变量(组织范围的持有者令牌)。
# 列出所有路由及其方法(获取实时 OpenAPI 规范,无需 API 密钥)
{baseDir}/scripts/sw-api.sh --help
# 显示特定路由的完整规范(参数、请求体、响应)
{baseDir}/scripts/sw-api.sh --help /v2/projects
# 列出所有项目(从这里开始了解组织结构)
{baseDir}/scripts/sw-api.sh /v2/projects
# 获取特定项目(包含其应用程序)
{baseDir}/scripts/sw-api.sh /v2/projects/{id}
# 创建项目
{baseDir}/scripts/sw-api.sh -m POST -d '{"name":"My Project"}' /v2/projects
# 更新项目
{baseDir}/scripts/sw-api.sh -m PATCH -d '{"name":"Renamed"}' /v2/projects/{id}
--help 标志需要 jq。
组织 → 项目 → 应用程序。每个应用程序都有一个 platform(ios、android、flutter、react_native、web)、一个 和一个 (用于 SDK 初始化 —— 与用于 REST 调用的组织 API 密钥不同)。
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
bundle_idpublic_api_keyGET /v2/projects 列出所有项目applications 数组以找到正确的平台public_api_key 进行 SDK 初始化,使用组织的 SUPERWALL_API_KEY 进行 REST API 调用基于游标。响应包含 has_more。将 limit(1-100)、starting_after 或 ending_before 作为查询参数传递。
API 密钥是组织范围的 —— 一个密钥授予对组织中所有项目和应用程序的访问权限。
https://superwall.com/select-application?pathname=/applications/:app/settings/api-keysSUPERWALL_API_KEY 存储在环境中。所有 Superwall 文档都以机器可读的格式提供。请勿硬编码文档内容 —— 始终获取实时版本。
| 资源 | URL | 使用场景 |
|---|---|---|
| 文档索引 | https://superwall.com/docs/llms.txt | 查找特定主题的正确文档页面 |
| 完整文档 | https://superwall.com/docs/llms-full.txt | 需要跨多个主题的全面上下文 |
| 单个页面 | curl -sL https://superwall.com/docs/{path}.md | 阅读特定文档页面 |
/docs/ios//docs/android//docs/flutter//docs/expo//docs/react-native//docs/dashboard//docs/web-checkout//docs/integrations/提示:首先获取 llms.txt 以找到确切的路径,然后使用 curl -sL 获取该页面。
对于 SDK 集成,请优先使用平台特定的快速入门技能(如果可用):
| 平台 | 技能 |
|---|---|
| iOS (Swift/ObjC) | superwall-ios-quickstart |
| Android (Kotlin/Java) | superwall-android-quickstart |
| Flutter | superwall-flutter-quickstart |
| Expo | superwall-expo-quickstart |
对于没有专用技能的平台(如 React Native),或者当快速入门技能未安装时,请遵循 references/sdk-integration.md 中的实时文档工作流程。
用于将用户链接到 Superwall 仪表板页面的 URL 模式。请参阅 references/dashboard-links.md。
克隆 SDK 仓库到本地以追踪内部行为。请参阅 references/sdk-source.md。
实时集成目录(与 Superwall 仪表板使用的来源相同):
curl -s https://webhooks.superwall.me/integrations
始终获取实时版本 —— 不要缓存。
关于 Webhook 和事件的通用文档,请从文档中获取:
curl -sL https://superwall.com/docs/integrations/webhooks.mdhttps://superwall.com/docs/llms.txt 并搜索 "events" 或 "analytics" 以找到完整的事件类型参考每周安装量
76
仓库
GitHub 星标数
7
首次出现
6 天前
安全审计
安装于
codex74
gemini-cli73
github-copilot73
amp73
cline73
opencode73
A bash helper is included at {baseDir}/scripts/sw-api.sh. It wraps the Superwall REST API V2.
Requires : SUPERWALL_API_KEY environment variable (org-scoped bearer token).
# List all routes with methods (fetches live OpenAPI spec, no API key needed)
{baseDir}/scripts/sw-api.sh --help
# Show full spec for a specific route (params, request body, responses)
{baseDir}/scripts/sw-api.sh --help /v2/projects
# List all projects (start here to discover the org structure)
{baseDir}/scripts/sw-api.sh /v2/projects
# Get a specific project (includes its applications)
{baseDir}/scripts/sw-api.sh /v2/projects/{id}
# Create a project
{baseDir}/scripts/sw-api.sh -m POST -d '{"name":"My Project"}' /v2/projects
# Update a project
{baseDir}/scripts/sw-api.sh -m PATCH -d '{"name":"Renamed"}' /v2/projects/{id}
The --help flag requires jq.
Organization → Projects → Applications. Each application has a platform (ios, android, flutter, react_native, web), a bundle_id, and a public_api_key (used for SDK initialization — distinct from the org API key used for REST calls).
GET /v2/projects to list all projectsapplications array to find the right platformpublic_api_key for SDK init, the org SUPERWALL_API_KEY for REST API callsCursor-based. Responses include has_more. Pass limit (1-100), starting_after, or ending_before as query params.
API keys are org-scoped — one key grants access to all projects and applications in the organization.
https://superwall.com/select-application?pathname=/applications/:app/settings/api-keysSUPERWALL_API_KEY in the environment.All Superwall documentation is available in machine-readable formats. Do not hardcode doc content — always fetch live.
| Resource | URL | Use when |
|---|---|---|
| Doc index | https://superwall.com/docs/llms.txt | Finding the right doc page for a topic |
| Full docs | https://superwall.com/docs/llms-full.txt | Need comprehensive context across many topics |
| Single page | curl -sL https://superwall.com/docs/{path}.md | Reading a specific doc page |
/docs/ios//docs/android//docs/flutter//docs/expo//docs/react-native//docs/dashboard//docs/web-checkout//docs/integrations/Tip : Fetch llms.txt first to find the exact path, then fetch that page with curl -sL.
For SDK integration, use the platform-specific quickstart skills when available:
| Platform | Skill |
|---|---|
| iOS (Swift/ObjC) | superwall-ios-quickstart |
| Android (Kotlin/Java) | superwall-android-quickstart |
| Flutter | superwall-flutter-quickstart |
| Expo | superwall-expo-quickstart |
For platforms without a dedicated skill (React Native), or when the quickstart skills are not installed, follow the live-doc workflow in references/sdk-integration.md.
URL patterns for linking users to Superwall dashboard pages. See references/dashboard-links.md.
Clone SDK repos locally to trace internal behavior. See references/sdk-source.md.
Live integration catalog (same source the Superwall dashboard pulls from):
curl -s https://webhooks.superwall.me/integrations
Always fetch live — do not cache.
For general webhook and event documentation, fetch from the docs:
curl -sL https://superwall.com/docs/integrations/webhooks.mdhttps://superwall.com/docs/llms.txt and search for "events" or "analytics" to find the full event type referenceWeekly Installs
76
Repository
GitHub Stars
7
First Seen
6 days ago
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
codex74
gemini-cli73
github-copilot73
amp73
cline73
opencode73
lark-cli 共享规则:飞书资源操作指南与权限配置详解
39,000 周安装