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를 사용하는 것이 좋습니다.
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 버전 관리 문서 페이지를 참조하세요.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2024-12-22(UTC)"],[],[],null,["# Getting started with the Looker API\n\n| **Note:** As of Looker 22.4, the [Looker API 4.0 is generally available](/looker/docs/api-4-ga). In Looker 23.18, the [Looker API 3.1 has been removed](/looker/docs/api-3x-deprecation).\n\nThe Looker API is a secure, \"RESTful\" application programming interface for managing your Looker instance and fetching data through the Looker data platform. With the Looker API, you can write applications or automation scripts to provision new Looker user accounts, run queries, schedule data deliveries, etc. Just about anything you can do in the Looker application you can do via the Looker API.\n\nLooker API path and port\n------------------------\n\nAccess your Looker instance's API through its API URL.\n\nYour Looker admin can specify an API path by entering it in the [**API Host URL**](/looker/docs/admin-panel-platform-api#api_host_url) field on the **Admin \\\u003e API** page in the following format: \n\n https://\u003cinstance_name\u003e.cloud.looker.com\n\nYour Looker admin may also use the [**API Host URL**](/looker/docs/admin-panel-platform-api#api_host_url) field to assign an API path that is different from your Looker server machine name. This is common when your Looker installation is behind a load balancer, for example. In this case, contact your Looker admin for your API path.\n\nIf your Looker admin has not specified the **API Host URL** field, Looker uses the default API path. For Looker instances hosted on Google Cloud, Microsoft Azure, and instances hosted on Amazon Web Service (AWS) that were created on or after 07/07/2020, the default Looker API path uses port `443`. For Looker instances hosted on AWS that were created before 07/07/2020, the default Looker API path uses port `19999`. The default API URL is in the following format: \n\n https://\u003cinstance_name\u003e.cloud.looker.com:\u003cport\u003e\n\nClient SDKs\n-----------\n\nYou can use the Looker API with any programming language or application environment that can make HTTPS requests and process JSON responses. You can construct Looker API HTTPS requests manually by using curl (or equivalent), by using the Looker Ruby SDK, or by generating a client SDK library for your language of choice. We recommend using an SDK because it takes care of the details of authentication and HTTPS requests for you, so that you can call the Looker API using simple function calls.\n\nYou'll find SDK details on our [Looker API SDKs](/looker/docs/api-sdk) documentation page.\n\nAuthentication\n--------------\n\nLooker authenticates API requests by using an OAuth 2.0 bearer access token in the HTTP authorization header of the request. All Looker API endpoints require a secure HTTPS connection so that the access token will be secure in transit.\n\nThe steps for achieving this depend upon whether or not you are using an SDK. Detailed instructions can be found on our [Looker API authentication](/looker/docs/api-auth) documentation page.\n\nInteractive API documentation\n-----------------------------\n\nFor API reference documentation, the API Explorer extension is available from the [Looker Marketplace](/looker/docs/marketplace). For more information, see the [Using the API Explorer](/looker/docs/api-explorer) documentation page. If you are a Looker admin, you can also access the API Explorer by clicking the **Use API Explorer** link on Looker's [**API** Admin page](/looker/docs/admin-panel-platform-api).\n\nVersioning\n----------\n\nAPI stability is an important consideration when building applications. In order to help you understand which endpoints may be changed in the future, and which should remain stable, we mark certain endpoints as being in beta. For more details, see the [Looker API versioning](/looker/docs/api-versioning) documentation page."]]
