Looker API는 Looker 인스턴스를 관리하고 Looker 데이터 플랫폼을 통해 데이터를 가져오는 보안 애플리케이션 프로그래밍 인터페이스입니다. Looker API를 사용하면 애플리케이션 또는 자동화 스크립트를 작성하여 새로운 Looker 사용자 계정을 프로비저닝하거나, 쿼리를 실행하거나, 보고서를 예약할 수 있습니다. Looker API를 통해 Looker 애플리케이션에서 할 수 있는 모든 작업을 할 수 있습니다.
Looker API 경로 및 포트
API URL을 통해 Looker 인스턴스의 API에 액세스합니다.
Looker 관리자는 Admin > API 페이지의 API 호스트 URL 입력란에 다음 형식 중 하나로 API 경로를 입력하여 지정할 수 있습니다.
https://<instance_name>.api.looker.com
또는
https://<instance_name>.api.<my_region>.looker.com
또는
https://<instance_name>.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>.looker.com:<port>
위의 API URL은 기본 API 버전 3.1에 연결됩니다. 지원 중단된 API 버전 3.0에 URL을
https://<instance_name>.looker.com:<port>/api/3.0/user또는https://<instance_name>.api.looker.com/api/3.0/user형식으로 지정하여 연결할 수도 있습니다.
클라이언트 SDK
HTTPS 요청을 보내고 JSON 응답을 처리할 수 있는 프로그래밍 언어 또는 애플리케이션 환경에서 Looker API를 사용할 수 있습니다. curl (또는 이에 상응하는 항목)을 사용하거나 Looker Ruby SDK를 사용하거나 원하는 언어로 클라이언트 SDK 라이브러리를 생성하여 Looker API HTTPS 요청을 직접 구성할 수 있습니다. SDK가 인증 및 HTTPS 요청 세부정보를 처리하므로 간단한 함수 호출을 사용하여 Looker API를 호출할 수 있으므로 이를 사용하는 것이 좋습니다.
SDK 세부정보는 Looker API SDK 문서 페이지에서 확인할 수 있습니다.
인증
Looker는 요청의 HTTP 승인 헤더에서 OAuth 2.0 Bearer 액세스 토큰을 사용하여 API 요청을 인증합니다. 모든 Looker API 엔드포인트는 보안 HTTPS 연결이 필요하기 때문에 전송 중 액세스 토큰이 안전하게 보호됩니다.
이를 위한 단계는 SDK 사용 여부에 따라 다릅니다. 자세한 안내는 Looker API 인증 문서 페이지에서 확인할 수 있습니다.
Interactive API 문서
API 참조 문서는 Looker Marketplace에서 API 탐색기 확장 프로그램을 사용할 수 있습니다. 자세한 내용은 API 탐색기 사용 문서 페이지를 참고하세요. Looker 관리자는 Looker의 API 관리 페이지에서 API 탐색기 사용 링크를 클릭하여 API 탐색기에 액세스할 수도 있습니다.
API 탐색기가 설치된 Looker 인스턴스에 액세스할 수 없는 경우 Looker 개발자 포털에서 공개 버전을 볼 수 있습니다.
버전 관리
API 안정성은 애플리케이션을 빌드할 때 중요한 고려사항입니다. Google Play에서는 향후 변경될 수 있는 엔드포인트와 안정화 상태를 유지해야 할 엔드포인트를 파악할 수 있도록 일부 엔드포인트를 베타 버전으로 표시합니다. 자세한 내용은 Looker API 버전 관리 문서 페이지를 참고하세요.