> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Postman으로 API에 프로그래밍 방식으로 액세스하기 > 이 가이드는 Postman을 사용해 ClickHouse Cloud API를 테스트하는 방법을 안내합니다 export const Image = ({img, alt, size = "lg"}) => { const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg"; return
{alt}
; }; 이 가이드는 [Postman](https://www.postman.com/product/what-is-postman/)을 사용해 ClickHouse Cloud API를 테스트하는 방법을 안내합니다. Postman 애플리케이션은 웹 브라우저에서 사용할 수 있으며, 데스크톱에 다운로드하여 사용할 수도 있습니다.
### 계정 만들기
* 무료 계정은 [https://www.postman.com](https://www.postman.com)에서 만들 수 있습니다. Postman 사이트
### 워크스페이스 만들기
* 워크스페이스 이름을 지정하고 공개 범위를 설정합니다. 워크스페이스 만들기
### Collection 생성
* 왼쪽 상단 메뉴에서 "Explore" 아래의 "Import"를 클릭합니다: Explore > Import * 모달 창이 나타납니다: API URL 입력 * API 주소 "[https://api.clickhouse.cloud/v1\"을](https://api.clickhouse.cloud/v1\"을) 입력하고 'Enter'를 누릅니다: * "Import" 버튼을 클릭하여 "Postman Collection"을 선택합니다: Collection > Import
### ClickHouse Cloud API 사양과 연동하기
* 이제 "ClickHouse Cloud용 API 사양"이 "Collections"(왼쪽 탐색 메뉴)에 표시됩니다. API 가져오기 * "ClickHouse Cloud용 API 사양"을 클릭합니다. 가운데 창에서 'Authorization' 탭을 선택하세요: 가져오기 완료
### 인증 설정
* 드롭다운 메뉴에서 "Basic Auth"를 선택합니다: Basic Auth * ClickHouse Cloud API keys를 설정할 때 받은 사용자 이름과 비밀번호를 입력합니다: 자격 증명
### 변수 사용 설정
* [변수](https://learning.postman.com/docs/sending-requests/variables/)를 사용하면 Postman에서 값을 저장하고 재사용할 수 있어 API 테스트를 더 쉽게 진행할 수 있습니다.
#### 조직 ID와 서비스 ID 설정
* "Collection"에서 가운데 창의 "Variable" 탭을 클릭합니다(기준 URL은 앞서 API를 가져올 때 이미 설정되어 있습니다). * `baseURL` 아래의 빈 "Add new value" 필드를 클릭한 다음, 조직 ID와 서비스 ID를 입력합니다: 조직 ID 및 서비스 ID
## ClickHouse Cloud API 기능 테스트
### "GET 사용 가능한 조직 목록" 테스트
* "ClickHouse Cloud용 OpenAPI spec" 아래에서 폴더 > V1 > organizations를 펼치십시오. * "GET 사용 가능한 조직 목록"을 클릭한 다음, 오른쪽의 파란색 "Send" 버튼을 누르십시오. 조직 조회 테스트 * 반환된 결과에는 "status": 200과 함께 조직 상세 정보가 표시되어야 합니다. ("status" 400이 반환되고 조직 정보가 표시되지 않으면 구성이 올바르지 않은 것입니다.) 상태
### "GET 조직 세부 정보" 테스트
* `organizationid` 폴더 아래에서 "GET 조직 세부 정보"로 이동합니다: * 가운데 프레임 메뉴의 Params 아래에서 `organizationid`가 필요합니다. 조직 세부 정보 조회 테스트 * 이 값을 중괄호로 감싼 `orgid` 값 `{{orgid}}`로 수정합니다(앞서 이 값을 설정했다면 해당 값이 포함된 메뉴가 표시됩니다): 테스트 제출 * "Save" 버튼을 누른 후 화면 오른쪽 상단의 파란색 "Send" 버튼을 누릅니다. 반환 값 * 반환된 결과에는 "status": 200과 함께 조직 세부 정보가 표시되어야 합니다. ("status" 400이 표시되고 조직 정보가 반환되지 않으면 구성이 올바르지 않은 것입니다).
### "GET service details" 테스트
* "GET service details"를 클릭하세요. * `organizationid` 및 `serviceid`의 값을 각각 `{{orgid}}` 및 `{{serviceid}}`로 수정하세요. * "Save"를 누른 다음 오른쪽의 파란색 "Send" 버튼을 누르세요. 서비스 목록 * 반환된 결과에는 서비스 목록과 각 서비스의 세부 정보가 "status": 200과 함께 표시되어야 합니다. ("status" 400이 표시되고 서비스 정보가 없으면 구성이 올바르지 않은 것입니다.)