用途:通过脚本向 ENCODE REST API 提交紧凑请求,完成对象查询、门户式搜索与元数据获取,适用于用户需要简洁 ENCODE 摘要的场景。
主要能力与用法:所有 ENCODE API 调用统一使用 scripts/rest_request.py,固定 base_url 为 https://www.encodeproject.org。对象查询通常不需要 max_items;门户式搜索建议使用 limit=10 与 max_items=10,并设置 Accept: application/json 头,必要时在参数中加 format=json。请求量应保持适度,避免大规模无过滤搜索;长对话中应重新发起请求,而不要依赖较早的工具输出。工具预览中显示的 ... 属于界面截断,并非实际请求内容。
输入:从 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。优先使用 accession 路径(如 biosamples/<accession>/)和搜索路径(如 search/)。
输出:成功时返回 ok、source、path、method、status_code、warnings,以及紧凑记录或紧凑摘要;需要完整负载时设置 save_raw=true,并通过 raw_output_path 报告保存文件路径。失败时返回 ok=false,并附带 error.code 与 error.message。
限制:资料未提供价格、收费、平台支持范围等额外信息;需注意控制请求规模,避免无过滤的大搜索。