api.ilepbase.com

概述

iLepBase REST API 为鳞翅目（蝴蝶与蛾类）综合生物信息学数据库提供程序化访问能力。可通过接口查询分类、基因组、DNA 条形码、寄主植物、形态学图像、转录组、文献、下载资源、蛋白质、BLAST 检索、MMNet 物种识别及 NicheBarcoding 工作流等数据。

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

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

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

主要特性

50+ 个公开接口，覆盖分类、数据集、组学、下载、蛋白质、BLAST、MMNet 与 NicheBarcoding
统一的 JSON 响应封装
基于 page / pageSize 的分页
分类与全局全文 / 联想检索
懒加载分类树（/tree/roots、/tree/children）

数据领域

通用

健康检查、版本、统计、工具目录、Swagger UI 与关于。

搜索

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

分类

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

文献

书目记录与文献详情。

基因组

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

条形码

DNA 条形码列表与筛选。

寄主植物

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

形态学

按科分组的形态学图像库。

组学

转录组与群体基因组数据集。

下载

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

工具

分析工具目录。

蛋白质

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

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
  }
}