TheYtree

Search or list paternal haplogroups by fuzzy name and/or parent, with stable ordering for full pagination (order=name recommended). 搜索/列出父系单倍群：按名称模糊匹配、按父节点筛选，稳定排序可完整枚举。

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Fuzzy name match, e.g. O-F15365 / 名称模糊匹配"
    },
    "parent": {
      "type": "string",
      "description": "Parent node (name/hid); returns only its direct children / 父节点（名称/hid），只返回直接子节点"
    },
    "level": {
      "type": "integer"
    },
    "order": {
      "type": "string",
      "enum": [
        "name",
        "endcounts",
        "level",
        "ages",
        "view_count",
        "snpcount"
      ],
      "default": "endcounts"
    },
    "order_dir": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "default": "desc"
    },
    "exclude_mf": {
      "type": "integer",
      "default": 0,
      "description": "1=exclude MagicCube (MF) names (matches the site); default 0 keeps all / 1=排除魔方(MF)名，默认0保留全部"
    },
    "page": {
      "type": "integer",
      "default": 1
    },
    "per_page": {
      "type": "integer",
      "default": 50,
      "maximum": 200
    }
  }
}

Get a single haplogroup by name / hid / SNP. 按名称/hid/SNP 获取单个单倍群详情。

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    }
  },
  "required": [
    "name"
  ]
}

List a haplogroup defining (equivalent) mutations (paternal / Y tree only). 获取某单倍群的等价突变（defining SNPs）列表（仅父系 Y 树）。

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "include_under_observation": {
      "type": "integer",
      "default": 0
    },
    "compact": {
      "type": "integer",
      "default": 0,
      "description": "1=compact fields only (snpid,snpname,haplogroup), much smaller / 1=仅返回精简字段，显著缩小体积"
    },
    "fields": {
      "type": "string",
      "description": "Custom fields (comma-separated), e.g. \"snpname,location\" / 自定义返回字段"
    },
    "page": {
      "type": "integer",
      "default": 1
    },
    "per_page": {
      "type": "integer",
      "default": 200,
      "maximum": 500
    }
  },
  "required": [
    "name"
  ]
}

Get the lineage chain from a haplogroup up to ROOT. Use limit to fetch only the most recent N levels (e.g. limit=2 for the node + its parent). 获取某单倍群上溯到 ROOT 的谱系链；可用 limit 只取最近 N 级（如 limit=2 即该节点与其直接父级）。

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Haplogroup name or hid / 单倍群名称或 hid"
    },
    "limit": {
      "type": "integer",
      "description": "Return only the most recent N levels (default: all). / 只返回最近 N 级，默认全部"
    }
  },
  "required": [
    "name"
  ]
}

Get the direct children of a haplogroup (for level-by-level traversal). Use limit for the N largest subclades only. 获取直接子节点（逐层遍历）；可用 limit 只看最大的 N 个分支。

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Haplogroup name or hid / 单倍群名称或 hid"
    },
    "limit": {
      "type": "integer",
      "description": "Return only the N largest children by size (default: all). / 只返回规模最大的 N 个直接子节点，默认全部"
    }
  },
  "required": [
    "name"
  ]
}

Resolve a SNP name to its haplogroup and return equivalent names (merged-name variants supported). 将 SNP 名解析到所属单倍群并返回等价名。

{
  "type": "object",
  "properties": {
    "snpname": {
      "type": "string"
    }
  },
  "required": [
    "snpname"
  ]
}

Batch-resolve up to 200 SNP names to their haplogroups (for reading a whole Y-SNP panel). 批量解析多个 SNP 名到所属单倍群（≤200/次）。

{
  "type": "object",
  "properties": {
    "snpnames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of SNP names, e.g. [\"M269\",\"M122\",\"F15365\"] / SNP 名数组"
    }
  },
  "required": [
    "snpnames"
  ]
}

Get a haplogroup subtree. Defaults to 6 levels (matches the site); small branches (root endcounts<=600) fully expand; max_depth overrides. Truncated boundary nodes carry has_children. 取子树：默认 6 层，小支(endcounts<=600)全展开，可传 max_depth；截断边界带 has_children。

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Subtree root name/hid / 子树根节点名称/hid"
    },
    "max_depth": {
      "type": "integer",
      "description": "Max levels relative to root (optional). Default 6; unlimited if root endcounts<=600 / 相对根最大层数（可选），默认6"
    }
  },
  "required": [
    "name"
  ]
}

Get service meta: summary, auth, dataset size (haplogroups / mutation records), and the tool list. 获取本服务元信息：简介、鉴权、数据集规模、工具清单。

{
  "type": "object",
  "properties": {}
}