쿼리 예시

다음은 일반적인 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 목록 조회

상태 및 Item 수가 포함된 워크스페이스의 모든 관리형 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
      }
    }
  }
}