Altium 365 API 빠른 시작 가이드

Altium 365 API는 Workspace 데이터(프로젝트, BOM, 컴포넌트, 심볼, 풋프린트 등)에 프로그래밍 방식으로 접근할 수 있게 해줍니다. GraphQL API이므로, 단일 요청으로 필요한 데이터만 정확히 조회할 수 있습니다.

이 가이드는 몇 분 안에 처음 API 호출을 할 수 있도록 처음부터 차근차근 안내합니다.

사전 준비

• Altium 365 Workspace

• Workspace 관리자 계정

• Altium Developer Center  계정 – 개발자를 위한 Altium의 셀프서비스 포털로, 여기서 Altium 365 API, Altium Designer SDK, Embeddable Viewer 및 기타 개발자 제품에 접근하기 위한 프로그램에 등록할 수 있습니다

1단계: 토큰 생성

API 요청을 인증하려면 액세스 토큰이 필요합니다. 토큰은 Workspace의 Admin → Developer에서 생성합니다.

토큰을 생성할 때 다음 두 가지 옵션 중에서 선택할 수 있습니다.

옵션 A: 장기 유효 액세스 토큰

가장 간단하게 시작하는 방법입니다. 유효 기간을 설정할 수 있는(최대 1년) 단일 액세스 토큰이 발급되며, 이를 API 요청에 직접 사용합니다.

적합한 용도: 빠른 탐색, 스크립트, 단순성이 중요한 통합

자세한 내용은 Using an Access token을 참조하세요.

옵션 B: 리프레시 토큰(프로덕션 환경 권장)

더 안전한 방식입니다. refresh token와 함께 client ID 및 client secret를 받게 됩니다. 리프레시 토큰은 프로그래밍 방식으로 짧은 수명의 액세스 토큰으로 교환되며, 이 액세스 토큰을 API 요청에 사용합니다. 리프레시 토큰 자체의 유효 기간도 설정할 수 있으며(최대 1년), 필요에 따라 짧은 수명의 액세스 토큰을 반복적으로 발급받는 데 사용합니다.

적합한 용도: 자동화된 통합, 백그라운드 서비스, 그리고 24/7로 운영되는 모든 프로덕션 환경

교환 흐름은 Using a Refresh Token을 참조하세요.

2단계: 첫 API 요청 보내기

Altium 365 API를 가장 빠르게 살펴보는 방법은 내장 브라우저 IDE(Nitro 기반)를 사용하는 것입니다. 다음으로 이동하세요:

https://{workspace-domain}.altium.com/api/graphql/

{workspace-domain}를 실제 Workspace 도메인으로 바꾸세요(예: mycompany.altium.com).

요청 인증하기

모든 API 요청에는 Authorization HTTP 헤더에 Bearer 스킴으로 전달되는 액세스 토큰이 필요합니다:

Authorization: Bearer {access-token}

첫 쿼리 실행하기

시작하기 좋은 쿼리는 Workspace 프로젝트 목록을 조회하는 것입니다:

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

이를 IDE에 붙여넣고 Run를 클릭하면, 응답에 Workspace 프로젝트가 표시될 것입니다.

다음 위치에서 전체 API 스키마를 시각적으로 탐색할 수도 있습니다:

https://{workspace-domain}.altium.com/api/voyager

다음 단계

• 데모 앱과 예제 쿼리를 보려면 AltiumDeveloper GitHub 조직을 살펴보세요

• 코드와 스크립트에서 토큰을 사용하는 방법은 Using an Access Token을 참조하세요

• 자동화된 통합에 대해서는 Using a Refresh Token 을 참조하세요