[GraphQL] Altair

Altair는 GraphQL API를 테스트하고 탐색할 수 있는 GraphQL 클라이언트(GraphQL Playground) 입니다.
GraphiQL과 비슷한 도구이며, GraphQL API 개발자 및 클라이언트 개발자가 요청을 쉽게 보내고 응답을 시각화할 수 있도록 도와줍니다.

---

Altair의 주요 특징

1. 직관적인 UI 및 사용성

• GraphQL 쿼리를 작성하고 실행할 수 있는 깔끔한 UI 제공
• 쿼리 히스토리 저장 기능 제공 (이전 요청 쉽게 확인 가능)
• 멀티탭 기능 지원 (여러 개의 API를 동시에 테스트 가능)

2. 다양한 인증 방식 지원

• API 테스트 시 헤더(Header) 및 인증(Authentication) 설정 가능
• JWT, Basic Auth, OAuth 등 다양한 인증 방식 지원
• GraphQL 서버에 인증 토큰을 쉽게 전달 가능

3. 자동 스키마 탐색 및 문서화

• 서버의 GraphQL 스키마를 자동으로 가져와 탐색 가능
• 자동완성(Auto-completion) 기능 지원 (쿼리 작성 편리)
• API 문서 기능 제공 (REST API의 Swagger와 유사)

4. 실시간 기능 지원 (Subscription)

• WebSocket 기반의 Subscription 지원 (실시간 데이터 테스트 가능)
• Subscription을 실행하면 자동으로 서버 변경 사항을 수신

5. 다양한 플랫폼 지원

• Windows, macOS, Linux에서 설치 가능
• Chrome 확장 프로그램 제공 (브라우저에서도 사용 가능)
• Docker 컨테이너로 실행 가능

 

Altair 설치 및 실행

1. 웹 브라우저에서 사용 (Chrome 확장 프로그램)

• Chrome Web Store에서 "Altair GraphQL Client" 설치 가능
  👉 Altair Chrome Extension

2. 데스크톱 애플리케이션 설치

• Windows/macOS/Linux 지원
• 공식 다운로드 페이지에서 설치
  👉 Altair 공식 사이트

3. Docker를 이용한 실행

docker run -p 4000:4000 altairgraphql/altair

• http://localhost:4000에서 실행됨

 

Altair 사용 방법

1. GraphQL API URL 설정

• http://localhost:4000/graphql 같은 API 엔드포인트 입력

2. 쿼리 작성 및 실행

query {
  user(id: "1") {
    name
    email
  }
}

• ▶️ (Run Query) 버튼 클릭 후 응답 확인

3. 헤더(Header) 설정

• 상단 Headers 섹션에서 인증 토큰 추가 가능

{
  "Authorization": "Bearer YOUR_ACCESS_TOKEN"
}

4. Subscription 실행

subscription {
  newMessage {
    content
    sender {
      name
    }
  }
}

• 서버에서 변경 사항 발생 시 자동으로 업데이트됨

 

Altair vs GraphiQL vs Postman

비교 항목 Altair GraphiQL Postman

UI & UX	✅ 직관적, 탭 지원	🔹 기본 UI	❌ REST 중심, GraphQL 지원은 제한적
쿼리 자동완성	✅ 지원	✅ 지원	❌ 제한적
Subscription 지원	✅ WebSocket 지원	❌ 기본 미지원	✅ 가능하지만 설정 복잡
인증 설정 (Auth)	✅ 헤더, JWT, OAuth 지원	🔹 기본 지원	✅ 강력한 지원
다중 요청 (Multi-tab)	✅ 지원	❌ 미지원	✅ 지원
플랫폼 지원	✅ Windows, macOS, Linux	✅ 웹 기반	✅ Windows, macOS, Linux