用途:通过脚本向 CELLxGENE Discover 公共 API 提交精简请求,获取公开的 collection 与 dataset 元数据,适合需要单细胞数据集合摘要的场景。
主要能力:所有调用统一使用 scripts/rest_request.py,base_url 固定为 https://api.cellxgene.cziscience.com/curation/v1。默认优先做定向的 collection 详情查询,而非全量归档导出;collections 列表可能很大,需要更高的 timeout_sec,因此通常先查 collections/<collection_id>,仅在用户明确需要广泛归档发现时才用 collections。
使用方式:从 stdin 读取一个 JSON 对象,必填字段为 base_url、path,可选字段包括 method、params、headers、json_body、form_body、record_path、response_format、max_items、max_depth、timeout_sec、save_raw、raw_output_path。示例命令:echo '{"base_url":"https://api.cellxgene.cziscience.com/curation/v1","path":"collections/db468083-041c-41ca-8f6f-bf991a070adf","max_items":5}' | python scripts/rest_request.py。成功返回 ok、source、path、method、status_code、warnings 以及精简记录或摘要;save_raw=true 时用 raw_output_path 保存原始输出;失败返回 ok=false 及 error.code、error.message。
输出与行为:默认返回精简 markdown 摘要,仅在用户明确要求机器可读输出时返回原始 JSON。长对话中应重新发起请求,不要依赖旧的工具输出。
限制:资料未提供更多运行时依赖说明,仅要求导入包限于本文件与 scripts/rest_request.py;未提供收费、平台或效果信息。