基因组

基因组组装列表、BUSCO 指标、详情视图、基因列表、染色体与质量诊断。

`GET /api/v1/genomes`

分页返回基因组组装列表，支持排序、筛选与分面导航。

curl "https://api.ilepbase.com/api/v1/genomes?page=1&pageSize=10&sortBy=buscoCompletePct&sortDirection=desc"

查询参数

名称	类型	必填	默认值	描述
`q`	`string`	否	—	在物种、科、属字段中进行全文检索。
`page`	`int`	否	`1`	页码。
`pageSize`	`int`	否	`10`	每页条目数。
`sortBy`	`string`	否	—	排序字段：`insectSpecies`、`family`、`subfamily`、`genus`、`sizeMb`、`n50Kb`、`buscoCompletePct`、`source`。
`sortDirection`	`string`	否	`desc`	`asc` 或 `desc`。
`family`	`string`	否	—	按科名筛选。
`subfamily`	`string`	否	—	按亚科名筛选。
`source`	`string`	否	—	按数据来源筛选，例如 `NCBI`。

响应

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "papilio-xuthus",
        "insectSpecies": "Papilio xuthus",
        "commonName": "柑橘凤蝶",
        "family": "Papilionidae",
        "subfamily": "Papilioninae",
        "genus": "Papilio",
        "sizeMb": 257,
        "n50Kb": 1240,
        "buscoCompletePct": 95.2,
        "source": "NCBI",
        "sourceUrl": "https://www.ncbi.nlm.nih.gov/assembly/GCA_000836235.1",
        "downloadUrl": "/downloads/papilio-xuthus-genome.fa.gz",
        "assemblyAccession": "GCA_000836235.1",
        "assemblyLevel": "chromosome",
        "hasBrowser": true
      }
    ],
    "pagination": {
      "page": 1, "pageSize": 10,
      "total": 48, "totalPages": 5,
      "hasNext": true, "hasPrev": false
    },
    "query": {
      "q": "",
      "page": 1, "pageSize": 10,
      "sortBy": "buscoCompletePct",
      "sortDirection": "desc",
      "family": null, "subfamily": null, "source": null,
      "hasBrowser": null
    },
    "facets": {
      "families": [
        { "value": "Papilionidae", "count": 12 },
        { "value": "Noctuidae", "count": 10 }
      ],
      "subfamilies": [ ... ],
      "sources": [
        { "value": "NCBI", "count": 35 },
        { "value": "GCA", "count": 13 }
      ]
    }
  },
  "timestamp": "2026-04-23T12:00:00.000Z"
}

关键字段

字段	类型	描述
`items[].insectSpecies`	`string`	科学名。
`items[].sizeMb`	`number`	基因组组装大小，单位 Mb。
`items[].n50Kb`	`number`	Scaffold N50，单位 Kb。
`items[].buscoCompletePct`	`number`	BUSCO 完整性百分比。
`items[].assemblyLevel`	`string`	组装级别：`chromosome`、`scaffold`、`contig`。
`items[].hasBrowser`	`boolean`	是否提供 JBrowse 基因组浏览器。

`GET /api/v1/genomes/{id}`

返回基因组完整详情：组装统计、BUSCO 质量诊断、基因列表、染色体 ideogram 数据、下载文件清单与关联出版物。

curl https://api.ilepbase.com/api/v1/genomes/papilio-xuthus

响应（节选）

{
  "success": true,
  "data": {
    "id": "papilio-xuthus",
    "family": "Papilionidae",
    "subfamily": "Papilioninae",
    "insectSpecies": "Papilio xuthus",
    "genus": "Papilio",
    "commonName": "柑橘凤蝶",
    "n50": "1.2 Mb",
    "busco": "95.2%",
    "assembly": {
      "accession": "GCA_000836235.1",
      "assemblyLevel": "chromosome",
      "genomeSizeMb": 257,
      "scaffoldCount": 210,
      "contigCount": 1845,
      "gcContent": 35.8,
      "chromosomeCount": 30,
      "scaffoldN50": "12.4 Mb",
      "contigN50": "1.2 Mb",
      "totalGapLengthMb": 12.3,
      "annotationMethod": "BRAKER2",
      "submitter": "iLepBase Consortium",
      "submissionDate": "2024-03-15"
    },
    "quality": {
      "summary": "BUSCO v5.4.4, Lepidoptera_odb10 (1690 markers)",
      "complete": { "percentage": 95.2, "count": 1608 },
      "singleCopy": { "percentage": 94.1, "count": 1590 },
      "duplicated": { "percentage": 1.1, "count": 18 },
      "fragmented": { "percentage": 1.8, "count": 30 },
      "missing": { "percentage": 3.0, "count": 50 },
      "markers": 1690,
      "lineageDataset": "Lepidoptera_odb10",
      "buscoVersion": "5.4.4",
      "mode": "genome",
      "genePredictor": "Augustus"
    },
    "genes": [
      {
        "geneId": "PXUT_00001",
        "symbol": "COI",
        "chromosome": "1",
        "start": 123456,
        "end": 125000,
        "strand": "+",
        "description": "Cytochrome c oxidase subunit I"
      }
    ],
    "chromosomes": [
      {
        "name": "1",
        "refName": "NC_045100.1",
        "length": 15234567,
        "gcContent": 35.2,
        "sortOrder": 1
      }
    ],
    "browser": {
      "datasetLabel": "Papilio xuthus genome",
      "assemblyName": "Pxut_1.0",
      "refName": "NC_045100.1",
      "regionStart": 1,
      "regionEnd": 15234567,
      "defaultLocation": "NC_045100.1:1..50000"
    },
    "downloads": [
      { "label": "Assembly (FASTA)", "format": "fasta.gz", "size": "87 MB", "href": "..." },
      { "label": "Annotation (GFF3)", "format": "gff3.gz", "size": "12 MB", "href": "..." },
      { "label": "Protein (FAA)", "format": "faa.gz", "size": "5 MB", "href": "..." }
    ],
    "publications": [
      {
        "title": "Chromosome-level genome assembly of Papilio xuthus",
        "authors": "Li J, Zhang A, et al.",
        "journal": "GigaScience",
        "year": 2024,
        "pubmedHref": "https://pubmed.ncbi.nlm.nih.gov/...",
        "doiHref": "https://doi.org/10.1093/..."
      }
    ]
  },
  "timestamp": "2026-04-23T12:00:00.000Z"
}

基因组

GET /api/v1/genomes

GET /api/v1/genomes/{id}

目录

`GET /api/v1/genomes`

`GET /api/v1/genomes/{id}`