用途:该技能用于让用户与 Getswift 数据交互。Getswift 是最后一公里配送平台,连接商家与本地司机完成按需配送,适用于零售、餐饮等需要快速送货的企业。
主要能力:可管理 Organizations、Projects、Users、Goals、Filters;核心对象包括 Delivery、Driver、Task、Recipient、Template。常见操作有 create-task(创建含取件与送件信息的配送任务)、get-delivery(按 ID 查询配送详情与跟踪信息)、list-drivers(列出商家账户关联的司机)。
使用方式:通过 Membrane CLI 调用,Membrane 自动处理认证与凭证刷新。安装:npm install -g @membranehq/cli;首次登录:membrane login --tenant(无头环境复制打印的 URL 供用户浏览器打开,再用 membrane login complete <code> 完成)。连接:membrane search getswift --elementType=connector --json 取 connector ID,再执行 membrane connect --connectorId=CONNECTOR_ID --json,用户在浏览器完成认证。查看已有连接:membrane connection list --json。查找动作:membrane action list --intent=QUERY --connectionId=CONNECTION_ID --json。运行动作:membrane action run --connectionId=CONNECTION_ID ACTION_ID --json,传参用 --input "{ "key": "value" }"。当现有动作不覆盖需求时,可用代理直接请求 API:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。
限制与建议:官方 API 文档见 https://getswift.zendesk.com/hc/en-us/categories/201155647-API。优先使用 Membrane 预置动作以获得内置认证、分页与错误处理;构建前先搜索已有动作;不要向用户索取 API 密钥或令牌,改用连接方式由 Membrane 服务端管理认证生命周期。具体收费、价格与平台支持范围暂未提供。