BLAST

BLAST 接口为可选能力，依赖 SequenceServer。未启用时返回 503，错误码 BLAST_NOT_CONFIGURED。

数据库 id 为 SequenceServer 生成的 hash，须先调用 GET /blast/databases 获取（不是目录名 COI_db）。

`GET /api/v1/blast/databases`

列出可用 BLAST 数据库。

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

响应示例（200）

{
  "success": true,
  "data": {
    "databases": [
      {
        "id": "a8ec2c5af1fbcab6b092a01f7acf8936",
        "title": "iLepBase COI BOLD nucleotide database",
        "type": "nucleotide",
        "sequenceCount": 2040921
      },
      {
        "id": "6c35a7dfb3730d44121898615f99b43e",
        "title": "iLepBase Lepidoptera protein database",
        "type": "protein",
        "sequenceCount": 42491179
      }
    ]
  },
  "timestamp": "2026-05-21T08:45:24.243Z"
}

`POST /api/v1/blast/search`

提交 BLAST 检索。在 BLAST_SYNC_TIMEOUT（默认 30 秒）内完成则同步返回 mode: sync；否则返回 202 与 jobId 供轮询。

请求体字段：sequence、program、database（必填），evalue、maxHits（可选）。

同步响应（200）：data.mode 为 sync，data.results 含 hits、stats（dbNum、dbLen、queryLen）。

异步响应（202）：data.mode 为 async，含 jobId、status: running。

`GET /api/v1/blast/jobs/{jobId}`

查询异步任务状态与结果（仅提交者 IP 可访问）。

与 Postman 集合 iLepBase API 同步。