/v1 작업을 포함하며,
인증이 미리 구성되어 있습니다.
다운로드
다운로드 링크를 클릭하면 파일이 제공되기 전에 Living Security 계정으로
로그인하라는 메시지가 표시됩니다.
Living Security API v1 컬렉션
모든
/v1 작업이 포함되어 있고 Basic 인증이 미리 구성된 Postman Collection v2.1입니다. 컬렉션 baseUrl은(는) 비어 있으므로 요청을 보내기 전에 리전 환경을 선택하십시오.컬렉션 다운로드프로덕션(US) 환경
baseUrl은(는) https://api.us-east-1.livingsecurity.ai/v1(으)로 미리 설정되어 있으며,
입력해야 하는 apiKeySecret 및 contractVersion 변수는 비어 있습니다.US 프로덕션 환경 다운로드프로덕션(EU) 환경
baseUrl은(는) https://api.eu-west-1.livingsecurity.ai/v1(으)로 미리 설정되어 있으며,
입력해야 하는 apiKeySecret 및 contractVersion 변수는 비어 있습니다.EU 프로덕션 환경 다운로드환경 템플릿
비프로덕션 설정을 위한 것으로, 동일한 변수를 포함하며
baseUrl은(는) 비어 있습니다.환경 템플릿 다운로드Postman에서 설정
1
파일 가져오기
Postman에서 가져오기를 선택하고 컬렉션 파일과 함께 해당 조직에 맞는
프로덕션(US) 또는 프로덕션(EU) 환경을 끌어다 놓습니다. 리전을 참조하십시오.
2
API 키 생성
대시보드에서 설정 → Integrations & Developers →
Developer Hub를 열고 서비스 계정을 만든 다음 API 키를 생성합니다. 키 시크릿은
lsk_live_(으)로 시작하며
한 번만 표시되므로 즉시 복사하십시오. 자세한 내용은
API 키를 참조하십시오.3
시크릿 붙여넣기
apiKeySecret 변수를 설정합니다. 가져온 환경에서 설정하거나(권장, 시크릿 유형 변수임)
컬렉션의 변수 탭에서 설정할 수 있습니다.4
요청 보내기
가져온 리전 환경을 선택하고 아무 요청이나 엽니다. 예를 들어
조직 → Retrieve the organization을 열고 보내기를 클릭합니다. 환경을 선택하기 전에는
요청을 보내지 마십시오. 컬렉션
baseUrl은(는) 의도적으로 비어 있습니다.인증이 미리 구성되는 방식
컬렉션은 컬렉션 수준에서 사용자 이름apikey 및
비밀번호 {{apiKeySecret}}(으)로 Basic 인증을 설정합니다. API는 두 Basic 인증 필드 중 어느 쪽에서든 키 시크릿을 허용하므로,
변수를 설정하면 별도 변경 없이 그대로 작동합니다.
Bearer 인증을 사용하려면 컬렉션의 Authorization 유형을
Bearer Token으로 변경하고 {{apiKeySecret}}을(를) 토큰으로 사용하십시오. API는
두 방식 모두에서 동일한 시크릿을 허용합니다.
API 키와 함께 Bearer 헤더를 사용하는 데에는 OAuth가 필요하지 않습니다. OAuth를 사용하려면
Bearer Token을 API 키 시크릿 대신 OAuth 액세스 토큰으로 설정하십시오.
방식을 선택하려면 인증을, 토큰 및 클라이언트 설정은
OAuth 클라이언트 자격 증명을 참조하십시오.
계약 버전 헤더
모든 요청에는{{contractVersion}}(으)로 미리 설정된 Living-Security-Version 헤더가 포함되며,
기본적으로 비활성화되어 있습니다. 비활성화된 상태로 두면 조직에 고정된 계약 버전이 사용됩니다. 활성화하면 요청을
게시된 특정 버전으로 고정합니다. 게시된 버전은 변경 로그를
참조하십시오.
쿼리 매개변수 및 본문
목록 엔드포인트 필터(limit, page_token 및 리소스별 필터)는
각 요청에 포함되어 있지만 비활성화되어 있으므로, 새로 가져온 상태에서도 모든
엔드포인트가 정상적으로 호출됩니다. 필요한 필터를 활성화하고 값을 입력하십시오. page_token의 작동 방식은
페이지 매김을 참조하십시오. POST 작업의 요청
본문에는 유형별 자리 표시자 값이 미리 채워져 있습니다.
컬렉션은 계약이 변경될 때마다 게시된 OpenAPI 사양에서 다시 생성됩니다. 최신 상태로 유지하려면
요청을 직접 수정하지 말고 새 사본을 다운로드하십시오.