贡献数据

通过程序或 AI 上传

将实验室系统、脚本或 AI 整理的反应记录提交到 iSynth。先按谁来执行上传选择方式，数据都会保存到你的账号草稿中。

只需手工上传现有表格时，可直接使用 网页上传。

从反应 JSON 到上传：完整示例

自动化实验室如何上传

在实验结果产生后，由实验室信息系统、仪器软件或脚本导出反应记录，再调用上传 API。适合固定流程和定期批量提交，普通脚本即可完成。

  1. 01

    导出记录

    准备 CSV 和数据集说明，保留实验编号与原始用量。

  2. 02

    调用上传接口

    用脚本传输文件，保存返回的草稿链接和上传编号。

  3. 03

    核对后提交

    查看入库结果，确认作者、来源和许可后提交审核。

从现成的 Python 上传脚本开始

下载脚本与元信息示例，将示例中的来源、作者和列映射替换为实际内容。脚本读取完整 CSV，自动处理行数、校验和与传输；只需 Python 标准库。

查看上传脚本 →查看元信息示例 →

按下方说明配置上传凭证后运行：

python upload_csv.py complete-source.csv instrument-intake.json

上传凭证与数据格式

创建 API Key

两种方式都使用绑定你账号的 iSynth API Key，上传选择 uploads:write 权限。上传的数据、作者信息与审核要求保持一致。

贡献规范与数据格式 →接口与字段参考 →
脚本的凭证配置
export ISYNTH_BASE_URL='https://your-isynth-host'
read -rs -p 'iSynth API key: ' ISYNTH_AUTOMATION_TOKEN
export ISYNTH_AUTOMATION_TOKEN

curl --fail-with-body "$ISYNTH_BASE_URL/api/automation/v1/me" \
  -H "Authorization: Bearer $ISYNTH_AUTOMATION_TOKEN"

Bash 示例；输入密钥时不回显，身份接口用于确认数据将归属哪个账号。

上传之后

回执提供草稿入口。先核对入库结果与数据说明，再提交审核；也可继续补充同一数据集的其他文件。

上传回执同时提供当前版本的引用预览。正式引用应使用已发布版本；数据集 DOI 注册服务尚未接入。

一个数据集可以上传多个文件

  1. 上传第一个文件，填写一次数据集和作者信息，获得草稿编号。
  2. 把其余文件追加到同一草稿版本，保留各自的原文件名。
  3. 所有文件上传并处理完成后，统一核对并提交审核。

上传中断后继续

继续原来的上传任务，已收到的内容不会重复添加。文件已经上传、但处理失败时，重试该文件的处理即可。

审核通过后才会发布。可以在草稿页面核对文件、修改说明并查看状态。

开发者调用说明

引用可通过 get_dataset_citation 获取；第三方 DOI 服务的元数据接口见 /api/citation/contract。来源论文 DOI 与数据集 DOI 分别记录。

每个文件分别调用 start_upload。第二个文件起传入首个回执中的 dataset_id 和 version_num，省略 dataset 与 authors。每个文件使用独立的 source_record_id；重试同一文件时保持不变。

start_upload → upload_batch (batch_index: 0, 1, …) → finish_upload
get_parse_report → submit_dataset_for_review → get_dataset_status

可通过 MCP 分批传输行数据，也可使用 start_upload 返回的地址通过 HTTP PUT 上传完整 CSV。同一文件的所有批次共用 upload_id；get_upload 查询进度。处理失败用 retry_file_processing；遇到 429 时按 Retry-After 重试。