api.ilepbase.com

概述

iLepBase REST API 为鳞翅目（蝴蝶与蛾类）综合生物信息学数据库提供程序化访问能力。数据模块按当前前端顺序组织：分类、基因组、转录组、蛋白结构、条形码、分布、寄主植物与文献；下载、工具和分析工作流接口继续保留。

基础 URL： https://api.ilepbase.com/api/v1

接口默认返回 JSON（另有说明的除外）。本文档收录无需认证的公开 API 接口。

文档与 Postman 集合 iLepBase API 同步。Auth、Admin 及内部 Jobs 相关接口均未纳入。

主要特性

按当前数据模块组织的公开接口，覆盖分类、基因组、转录组、蛋白结构、条形码、分布、寄主植物与文献
统一的 JSON 响应封装
基于 page / pageSize 的分页
分类与全局全文 / 联想检索
懒加载分类树（/tree/roots、/tree/children）

数据领域

通用

健康检查、版本、统计、Swagger UI 与关于。

搜索

全局联想建议与导航入口。

分类

树导航、检索、联想、节点详情与文献。

基因组

组装目录与单条基因组详情。

转录组

转录组数据集与表达概览。

蛋白结构

蛋白质目录、详情记录与 PDB 结构数据。

条形码

DNA 条形码列表与筛选。

分布

标本分布列表、地图概览与矢量瓦片。

寄主植物

昆虫–寄主植物关联记录。

文献

书目记录与文献详情。

下载

资源目录、文件元数据、流式下载与物种下载。

工具

分析工具目录、仓库链接、状态与标签。

BLAST

序列相似性检索与可用数据库列表。

MMNet

基于图像与条形码的多模态物种识别。

NicheBarcoding

生态位条形码工作流 — 提交、轮询与结果下载。

响应结构

每次响应均采用如下结构：

{
  "success": true,
  "data": { ... },
  "timestamp": "2026-04-23T12:00:00.000Z"
}

错误时返回 "success": false，并附带 error 对象：

{
  "success": false,
  "error": {
    "code": "PROTEIN_NOT_FOUND",
    "message": "Protein record does not exist."
  },
  "timestamp": "2026-04-23T12:00:00.000Z"
}

分页列表会包含 pagination 对象：

{
  "pagination": {
    "page": 1,
    "pageSize": 10,
    "total": 48200,
    "totalPages": 4820,
    "hasNext": true,
    "hasPrev": false
  }
}