用途:该技能面向一类固定工作流,帮助在 Make 中搭建可复用的 API 调用外壳(shell),作为通用 SaaS 检索通道,可用于邮件、CRM、工单、客服、营销、任务等系统。技能核心是“准备与搭建”,业务检索视为连接就绪并校验外壳后的第二阶段。
主要能力:发现正确的 Make 应用及应用专属 API 调用模块;复用或新建包含 scenario-service:StartSubscenario、一个应用 API 调用模块、scenario-service:ReturnData 的外壳场景;复用合适连接或发起凭据请求,授权完成后把连接补丁到外壳;运行场景并作为通用 API 传输层使用。
使用方式(操作序列):解析提供方(如 Gmail/Outlook、HubSpot/Salesforce、Jira/Zendesk/Linear)与目标账号、Make 区域、组织与团队;通过 GET /api/v2/imt/apps/{appName}/{version} 确定模块 slug 与两层连接类型;用 GET /api/v2/connections/{connectionId} 与 POST /api/v2/connections/{connectionId}/test 验证连接活性;仅在无可用连接时创建凭据请求;按“复用连接才复用外壳、新授权连接须新建外壳”的规则创建或打补丁;设置场景级 interface 并用 /api/v2/scenarios/{scenarioId}/run 运行,先跑最窄检索再扩展。
外壳契约:三模块外壳接收 path、method、header、qs、body 并转发给应用 API 调用模块,只返回该模块的响应体,即 data: {{MIDDLE_API_MODULE_ID.body}}。示例蓝图中中间模块 id 为 3,故示例为 {{3.body}};实际导出中须按真实模块 id 替换,不要用 {{MIDDLE_API_MODULE_ID}} 或 .data 替代。qs 作为一等输入承载查询参数。默认用 GET;PUT、PATCH、DELETE 视为写/破坏性操作,执行前须明确警告与确认。
限制与注意:不得猜测模块名,须从当前元数据发现;社区应用(communityApp-*)不参与匹配,若无应用则改用 http:MakeRequest 的通用 HTTP 回退外壳;不要求用户粘贴密钥,改用凭据请求;跨区域团队调用前先确认区域,否则可能 403;UI 导出与场景创建/更新 API 的 flow 形状不同,需归一化后再提交;外壳复用是应用专属的,不能因同厂商就重定向到另一模块;公开示例需脱敏,默认基址用 https://us1.make.com。关于具体收费、价格与效果,资料暂未提供。