通用

服务索引、健康检查、版本元数据、数据库统计、工具目录与服务元数据。

`GET /api/v1`

API 根入口。返回服务名称、版本以及可用公开接口列表。

curl https://api.ilepbase.com/api/v1

响应

{
  "success": true,
  "data": {
    "name": "iLepBase API",
    "version": "v1",
    "endpoints": [
      "/api/v1/health",
      "/api/v1/version",
      "/api/v1/stats",
      "/api/v1/meta/summary",
      "/api/v1/search/suggestions",
      "/api/v1/taxonomy/tree/roots",
      "/api/v1/genomes",
      "/api/v1/barcodes",
      "/api/v1/hostplants",
      "/api/v1/morphology",
      "/api/v1/proteins",
      "/api/v1/downloads",
      "/api/v1/omics/transcriptomes",
      "/api/v1/omics/population-genomes",
      "/api/v1/tools",
      "/api/v1/blast/databases",
      "/api/v1/mmnet/health",
      "/api/v1/niche-barcoding/schemas"
    ]
  },
  "timestamp": "2026-04-23T12:00:00.000Z"
}

`GET /api/v1/health`

健康检查接口，返回服务状态与版本。

curl https://api.ilepbase.com/api/v1/health

响应

{
  "success": true,
  "data": {
    "status": "ok",
    "service": "ilepbase-api",
    "version": "v1"
  },
  "timestamp": "2026-04-23T12:00:00.000Z"
}

`GET /api/v1/version`

返回 API 版本与构建元数据。

curl https://api.ilepbase.com/api/v1/version

`GET /api/v1/stats`

数据库整体统计信息，包括各数据域记录数与最后更新时间。

curl https://api.ilepbase.com/api/v1/stats

`GET /api/v1/meta/summary`

汇总各公开数据域的统计信息。

curl https://api.ilepbase.com/api/v1/meta/summary

响应

{
  "success": true,
  "data": {
    "families": 126,
    "species": 114852,
    "barcodes": 48200,
    "dataDomains": 8,
    "updatedAt": "2026-04-20T08:00:00.000Z"
  },
  "timestamp": "2026-04-23T12:00:00.000Z"
}

字段	类型	描述
`families`	`int`	数据库中的鳞翅目科数量。
`species`	`int`	物种记录总数。
`barcodes`	`int`	DNA 条形码记录总数。
`dataDomains`	`int`	活跃数据模块数量。
`updatedAt`	`string`	最近一次数据更新的 ISO 8601 时间戳。

`GET /api/v1/tools`

列出与平台关联的分析工具。完整响应结构见工具页面。

curl https://api.ilepbase.com/api/v1/tools

`GET /api/v1/about`

返回服务版本、构建元数据、记录数量以及最后更新时间。

curl https://api.ilepbase.com/api/v1/about

响应字段

字段	类型	描述
`version`	`string`	API / 服务版本。
`gitCommit`	`string`	构建版本标识符。
`speciesCount`	`int`	数据库中的物种总数。
`genomeCount`	`int`	基因组组装总数。
`updatedAt`	`string`	最近一次数据更新的 ISO 8601 时间戳。

`GET /swagger/index.html`

API 交互式 Swagger UI 文档。位于服务根路径（不在 /api/v1 下）。

curl https://api.ilepbase.com/swagger/index.html

`GET /metrics`

Prometheus 指标端点。仅在服务端启用指标采集时可用。

curl https://api.ilepbase.com/metrics