🚀 快速安装
复制以下命令并运行，立即安装此 Skill：
clawhub install 7shifts💡 提示：需要提前安装 clawhub CLI
7shifts
7shifts 是一个专为餐饮业设计的排班和劳动力管理平台。它帮助餐厅经理安排员工班次、跟踪考勤和管理劳动力成本。餐厅老板、总经理和轮班主管是其主要用户。
官方文档：https://developers.7shifts.com/
7shifts 概述
- 班次
- 班次互换
- 打卡记录
- 用户
- 账户
- 公司
- 角色
- 门店
- 可用性
- 排班表
- 公告
- 小费池
- 工资
- 任务列表
- 劳动力成本
- 销售预测
- 集成
- 报表
- 现金抽屉
- 休息
- 检查清单
- 活动
- 表单模板
- 表单
- 培训模块
- 培训进度
- 学习管理系统
- 文件
- 文件夹
- 共享链接
根据需要使用操作名称和参数。
使用 7shifts
此技能使用 Membrane CLI 与 7shifts 交互。Membrane 自动处理认证和凭证刷新 — 因此您可以专注于集成逻辑而非认证细节。
安装 CLI
安装 Membrane CLI，以便从终端运行 membrane：
npm install -g @membranehq/cli
首次设置
membrane login --tenant
浏览器窗口将打开进行认证。
无头环境：运行命令，复制打印的 URL 让用户在浏览器中打开，然后使用 membrane login complete <代码> 完成。
连接到 7shifts
- 创建新连接：
membrane search 7shifts --elementType=connector --json从
output.items[0].element?.id获取连接器 ID，然后：membrane connect --connectorId=连接器ID --json用户在浏览器中完成认证。输出中包含新的连接 ID。
获取现有连接列表
当不确定连接是否已存在时：
- 检查现有连接：
membrane connection list --json如果存在 7shifts 连接，记录其
connectionId
搜索操作
当您知道想要做什么但不清楚确切的操作 ID 时：
membrane action list --intent=查询意图 --connectionId=连接ID --json
这将返回包含 ID 和 inputSchema 的操作对象，因此您将知道如何运行它。
常用操作
| 名称 | 键名 | 描述 |
|---|---|---|
| 列出休假申请 | list-time-off | 列出休假申请 |
| 列出角色 | list-roles | 列出公司的所有角色 |
| 列出部门 | list-departments | 列出公司的所有部门 |
| 创建打卡记录 | create-time-punch | 创建新的打卡记录（签到/签退记录） |
| 列出打卡记录 | list-time-punches | 列出公司的打卡记录，支持筛选选项 |
| 删除班次 | delete-shift | 删除班次 |
| 更新班次 | update-shift | 更新现有班次 |
| 创建班次 | create-shift | 创建新班次 |
| 获取班次 | get-shift | 通过 ID 检索特定班次 |
| 列出班次 | list-shifts | 列出公司的班次，支持筛选选项 |
| 停用用户 | deactivate-user | 停用（软删除）用户 |
| 更新用户 | update-user | 更新现有用户的信息 |
| 创建用户 | create-user | 在 7shifts 中创建新用户（员工） |
| 获取用户 | get-user | 通过 ID 检索特定用户 |
| 列出用户 | list-users | 列出公司的所有用户（员工） |
| 获取门店 | get-location | 通过 ID 检索特定门店 |
| 创建门店 | create-location | 为公司创建新门店 |
| 列出门店 | list-locations | 列出公司的所有门店 |
| 获取公司 | get-company | 通过 ID 检索特定公司 |
| 列出公司 | list-companies | 列出认证用户可访问的所有公司 |
运行操作
membrane action run --connectionId=连接ID 操作ID --json
传递 JSON 参数：
membrane action run --connectionId=连接ID 操作ID --json --input "{ \"key\": \"value\" }"
代理请求
当可用操作无法满足您的用例时，您可以通过 Membrane 的代理直接向 7shifts API 发送请求。Membrane 会自动将基础 URL 附加到您提供的路径，并注入正确的认证头 — 包括在凭证过期时的透明刷新。
membrane request 连接ID /路径/到/端点
常用选项：
| 标志 | 描述 |
|---|---|
-X, --method |
HTTP 方法（GET、POST、PUT、PATCH、DELETE）。默认为 GET |
-H, --header |
添加请求头（可重复），例如 -H "Accept: application/json" |
-d, --data |
请求体（字符串） |
--json |
发送 JSON 体的简写，并设置 Content-Type: application/json |
--rawData |
按原样发送请求体，不进行任何处理 |
--query |
查询字符串参数（可重复），例如 --query "limit=10" |
--pathParam |
路径参数（可重复），例如 --pathParam "id=123" |
最佳实践
- 始终优先使用 Membrane 与外部应用通信 — Membrane 提供预构建的操作，内置认证、分页和错误处理。这将消耗更少的令牌并使通信更安全
- 在构建前先探索 — 在编写自定义 API 调用之前，运行
membrane action list --intent=查询意图（将”查询意图”替换为您的意图）来查找现有操作。预构建的操作能处理原始 API 调用可能遗漏的分页、字段映射和边缘情况。 - 让 Membrane 处理凭证 — 切勿要求用户提供 API 密钥或令牌。而是创建连接；Membrane 在服务器端管理完整的认证生命周期，本地不存储任何密钥。
📄 原始文档
来源地址：
https://clawhub.com/skills/7shifts
声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。
评论(0)