Looker API는 Looker 인스턴스를 관리하고 Looker 데이터 플랫폼을 통해 데이터를 가져오기 위한 안전한 'RESTful' 애플리케이션 프로그래밍 인터페이스입니다. Looker API를 사용하면 애플리케이션 또는 자동화 스크립트를 작성하여 새 Looker 사용자 계정을 프로비저닝하고, 쿼리를 실행하고, 보고서를 예약할 수 있습니다. Looker API를 통해 수행할 수 있는 거의 모든 작업이 Looker 애플리케이션에서 가능합니다.
Looker API 경로 및 포트
API URL을 통해 Looker 인스턴스의 API에 액세스합니다.
Looker 관리자는 다음과 같은 형식으로 관리 > API 페이지의 API 호스트 URL 필드에 입력하여 API 경로를 지정할 수 있습니다.
https://<instance_name>.cloud.looker.com
Looker 관리자는 API 호스트 URL 필드를 사용하여 Looker 서버 머신 이름과 다른 API 경로를 할당할 수도 있습니다. 예를 들어 Looker 설치가 부하 분산기 뒤에 있는 경우 이런 방식이 일반적입니다. 이 경우 API 경로에 대한 Looker 관리자에게 문의하세요.
Looker 관리자가 API 호스트 URL 필드를 지정하지 않은 경우 Looker는 기본 API 경로를 사용합니다. Google Cloud, Microsoft Azure에서 호스팅되는 Looker 인스턴스와 2020년 7월 7일 이후에 생성된 Amazon Web Service(AWS)에서 호스팅되는 인스턴스의 경우 기본 Looker API 경로는 포트 443을 사용합니다. 2020년 7월 7일 이전에 생성된 AWS에서 호스팅되는 Looker 인스턴스의 경우 기본 Looker API 경로는 포트 19999를 사용합니다. 기본 API URL 형식은 다음과 같습니다.
https://<instance_name>.cloud.looker.com:<port>
클라이언트 SDK
HTTPS 요청을 수행하고 JSON 응답을 처리할 수 있는 모든 프로그래밍 언어 또는 애플리케이션 환경에서 Looker API를 사용할 수 있습니다. curl 또는 Looker Ruby SDK를 사용하거나 원하는 언어의 클라이언트 SDK 라이브러리를 생성하여 Looker API HTTPS 요청을 수동으로 구성할 수 있습니다. SDK 및 OAuth 요청의 세부정보를 처리하므로 간단한 함수 호출을 통해 Looker API를 호출할 수 있으므로 SDK를 사용하는 것이 좋습니다.
SDK 세부정보는 Looker API SDK 문서 페이지에서 확인할 수 있습니다.
인증
Looker는 요청의 HTTP 승인 헤더에서 OAuth 2.0 Bearer 액세스 토큰을 사용하여 API 요청을 인증합니다. 모든 Looker API 엔드포인트는 전송 중인 토큰을 안전하게 보호하기 위해 보안 HTTPS 연결이 필요합니다.
이를 수행하는 단계는 SDK 사용 여부에 따라 다릅니다. 자세한 내용은 Looker API 인증 문서 페이지에서 확인하세요.
대화형 API 문서
API 참조 문서의 경우 Looker Marketplace에서 API 탐색기 확장 프로그램을 사용할 수 있습니다. 자세한 내용은 API 탐색기 사용 문서 페이지를 참조하세요. Looker 관리자인 경우 Looker의 API 관리 페이지에서 API 탐색기 사용 링크를 클릭하여 API 탐색기에 액세스할 수도 있습니다.
버전 관리
API 안정성은 애플리케이션을 빌드할 때 중요한 고려사항입니다. Google에서는 향후 변경될 수 있는 엔드포인트와 안정적으로 유지해야 하는 엔드포인트를 이해할 수 있도록 특정 엔드포인트를 베타 버전으로 표시합니다. 자세한 내용은 Looker API 버전 관리 문서 페이지를 참조하세요.