数据与帮助

脚本、仪器和其他工具

用 API 令牌让脚本、R 和仪器读写实验室的数据，比如让天平自动记录体重。

BioManager 提供 API：其他程序可以以你的身份读取和修改实验室的记录。把某个实验的体重 直接拉进 R 或 Python，让天平每称一次就上传一次体重，让平台的系统把样本标记为已完成，或者为 设施统计笼数——都不用任何人去导出表格。

1. 设置 → API 令牌（Settings → API tokens）：写明谁会用它（B12 的天平、我的 R 脚本），权限是 只读（Read）还是读写（Read and change），以及到期时间。点生成令牌（Make a token）。
2. 复制令牌：它只显示一次。像对待密码一样对待它，不要写进你要分享的脚本里（通常放在环境 变量里）。
3. 每次请求都带上它，格式为 Authorization: Bearer bmt_…。API 参考（API reference，同一张 卡片上的链接，或你的 BioManager 上的 /api）列出它能读取和修改的所有内容，附有 curl、Python 和 R 示例。

• 令牌就是你。它能做的和你在页面上能做的一样，不会更多；用它做的修改会以你的名义记在修改历史里， 并标注令牌名称。
• 它可以读取小鼠、笼、窝、品系、鱼缸和鱼、质粒、果蝇和线虫的管/皿、所有库存和所有 实验；可以修改小鼠（笼、基因型、备注、状态……）、记录体重、修改果蝇管、添加或修改 库存物品，以及记录实验的观测指标。
• 每个使用它的东西单独建一个令牌，这样可以撤销（Revoke）其中一个而不影响其他。卡片上显示每个令牌 最近一次使用的时间。管理员能看到所有人的令牌并撤销任何一个；设置（Setup）可以规定只有管理员能建令牌。
• 桌面版只有那台电脑上的程序能访问；实验室服务器则是任何能连上服务器的东西都能访问。