查询示例

以下是针对常见 Altium 365 API 用例的可直接运行的查询。所有示例均使用工作区端点，并需要有效的访问令牌。

发现

列出工作区

获取用户的工作区列表，包括 API 端点 URL。

query {
  desWorkspaceInfos { 
    name
    description
    url
    location {
      apiServiceUrl
      filesServiceUrl
    }
  }
}

项目

列出项目

query {
  desProjects(first: 10) {
    nodes {
      id
      name
      description
      projectType
      updatedAt
    }
  }
}

获取项目详情

根据 ID 获取特定项目，包括其设计数据、最新修订版本和协作者。

query GetProject($id: ID!) {
  desProjectById(id: $id) {
    id
    name
    description
    projectType
    createdAt
    updatedAt
    design {
      releases {
        totalCount
      }
      variants {
        name
      }
    }
    latestRevision {
      author
      createdAt
      message
      revisionId
    }
  }
}

库

获取库概览

返回工作区库及其元件、封装和符号数量。

query GetLibraryOverview{
  desLibrary {
    name
    description
    updatedAt
    components {
      nodes {
        id
        name
      }
    }
    footprints {
      totalCount
    }
    symbols {
      totalCount
    }
  }
}

采购

列出 BOM

返回工作区中的所有受管 BOM，包括健康状态和条目数量。

query {
  bomBoms(first: 5) {
    nodes {
      bomId
      name
      createdAt
      updatedAt
      items {
        totalCount
      }
      releases {
        totalCount
        nodes {
          name
          releasedAt
          releaseNotes
        }
      }
      issues {
        severity
        description
        howToFix
      }
    }
  }
}

工作区团队

列出工作区成员

query ListWorkspaceUsers {
  desWorkspaceTeamByAuth {
    workspaceGroups {
      nodes {
        id
        name
      }
    }
    workspaceUsers {
      nodes {
        id
        displayName
        email
      }
    }
  }
}