액세스 토큰 사용

액세스 토큰은 Altium 365 API 요청을 인증합니다. 모든 요청의 Authorization 헤더에 Bearer 토큰으로 포함해야 합니다.

액세스 토큰은 두 가지 방법으로 얻을 수 있습니다.

• Directly – Admin → Developer에서 장기 액세스 토큰 생성

• Via exchange – 갱신 토큰을 사용하여 단기 액세스 토큰 생성(이 토큰은 Admin → Developer에 표시되지 않음)

토큰을 얻은 방법에 관계없이 인증 방식은 동일합니다.

인증 헤더

Authorization: Bearer {access-token}

예: curl

curl -X POST https://{workspace-domain}/api/graphql/ \
  -H "Authorization: Bearer {access-token}" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ desProjects(first: 5) { nodes { id name } } }"}'

토큰 만료

Long-lived access tokens은 생성 시 설정한 유효 기간(최대 1년)이 지나면 만료됩니다. 만료되면 Admin → Developer에서 새 토큰을 생성해야 합니다.

Short-lived access tokens(갱신 토큰 교환으로 얻은 토큰)은 짧은 시간이 지나면 만료됩니다. 만료되면 갱신 토큰을 다시 교환하여 새 액세스 토큰을 받으세요. 갱신 토큰 사용을 참조하세요.

만료된 토큰을 사용하면 API 요청이 401 Unauthorized를 반환하거나, GraphQL 응답에 오류 코드 AuthExpiredToken이 포함된 200 OK를 반환합니다.

보안

• 액세스 토큰을 클라이언트 측 코드에 삽입하거나 소스 제어에 커밋하지 마세요.

• 장기간 실행되는 자동화된 통합에는 갱신 토큰 방식을 권장합니다. 단기 액세스 토큰을 사용하면 토큰이 유출되더라도 악용될 수 있는 시간을 제한할 수 있습니다.

관련 항목

• 갱신 토큰 사용