API

OpsIQ API 기능 및 SDK 참조에 대해 알아보세요.

OpsIQ API는 멱등성을 지원하나요?
예, 개발자 모델에는 쓰기에 대한 멱등성 재생 보호가 포함되어 있습니다. 이 기능은 지원되는 작업에 대해 문서화된 24시간 멱등성 창을 포함합니다. 클라이언트는 네트워크 장애 후 동일한 의도된 쓰기를 재시도할 때 동일한 키를 재사용해야 합니다. 진정으로 새로운 작업의 경우, 새로운 키를 생성해야 합니다. 관련 기사 개발자 API, 웹후크 및 커넥터 빌더 — OpsIQ OpsIQ 문서 및…
2,892
OpsIQ 아웃바운드 웹훅은 어떻게 서명되나요?
OpsIQ는 원시 요청 본문에 대해 HMAC-SHA256을 사용하여 아웃바운드 웹훅 페이로드에 서명합니다. 또한 타임스탬프 및 이벤트와 같은 전송 메타데이터를 포함합니다. 수신자는 다음 단계를 따라야 합니다: 정확한 원시 본문에서 서명을 계산합니다. 계산된 서명을 일정한 시간에 비교합니다. 타임스탬프를 검증합니다. 반복된 전송을 멱등성 있게 처리합니다. 관련 기사 자동화를 위한 서명된 웹훅…
2,873
OpsIQ 일반 API를 통해 사용할 수 있는 작업 수는 얼마입니까?
현재 개발자 및 통합 페이지는 1,558개의 명명된 일반 API 작업과 62개의 최소 권한 범위에 대해 설명합니다. 작업 레지스트리는 API 동작, 작업 문서, 범위 및 검증이 일관되도록 보장합니다. 통합은 실제로 필요한 작업만 호출해야 합니다. 관련 기사 개발자 API, 웹후크 및 커넥터 빌더 — OpsIQ OpsIQ 문서 및 개발자 문서 — OpsIQ 포털 스튜디오 관리자 및 개발자…
2,859
OpsIQ API는 드라이 런 요청을 지원하나요?
네, OpsIQ API는 드라이 런 요청을 지원합니다. 지원되는 작업은 dry_run 동작을 활용할 수 있어, 통합자가 쓰기를 커밋하지 않고도 의도와 매개변수를 검증할 수 있습니다. 이 기능은 특히 고충격 자동화 및 테스트에 유용합니다. 그러나 드라이 런은 스테이징을 대체하지 않으며, 모든 외부 부작용을 안전하게 재현할 수는 없다는 점에 유의해야 합니다. 관련 기사 개발자 API, 웹후크…
2,822
OpsIQ는 어떤 SDK 및 API 참조 형식을 제공하나요?
OpsIQ는 OpenAPI 3.0.3 설명, Postman 리소스 및 PHP, Node.js, Python에 대한 헬퍼 패턴을 제공합니다. 이를 통해 팀은 단일 독점 SDK에 의존하는 대신 선호하는 기술 스택과 통합할 수 있습니다. 그러나 비밀 처리, 타임아웃, 재시도 및 멱등성과 같은 측면에 대해 생성된 클라이언트를 검토하는 것이 중요합니다. 관련 기사 OpsIQ에서 API 속도 제한�…
2,660
API 토큰을 삭제하지 않고 일시적으로 비활성화할 수 있나요?
예, API 토큰은 토큰을 비활성화하고 나중에 다시 활성화하는 것을 지원합니다. 통합이 일시적으로 사용을 중단해야 할 때 토큰을 비활성화할 수 있습니다. 해당 토큰이 비활성화되어 있는 동안 연결된 통합은 인증에 실패할 것임을 기억해 주세요. 관련 기사 OpsIQ의 아웃바운드 웹훅은 어떻게 서명되나요? OpsIQ 일반 API에 어떻게 인증하나요? OpsIQ 일반 API를 통해 사용할 수 있는…
2,560
OpsIQ에서 API 속도 제한은 어떻게 작동합니까?
OpsIQ는 키별로 API 속도 제한을 적용하고 응답 헤더에 속도 제한 정보를 반환합니다. 제한이 초과되면 클라이언트는 HTTP 429 상태 코드를 수신하며, Retry-After 헤더를 통해 재시도 시점에 대한 안내를 받습니다. 통합은 즉시 재시도하기보다는 백오프 전략을 구현해야 합니다. 계획 제한은 키, 작업, 웹후크, 통합 및 트리거에 대해 별도로 적용된다는 점을 기억하는 것이…
2,543
API 토큰에 대해 어떤 정보를 볼 수 있나요?
API Tokens 페이지는 각 토큰에 대한 다양한 세부정보를 제공합니다, 포함하여: 토큰 이름 공개 식별자 부여된 권한 현재 상태 사용 정보 (예: 마지막 사용 시점) 생성 후 비밀 자체는 다시 표시되지 않습니다. 관련 기사 OpsIQ의 아웃바운드 웹훅은 어떻게 서명되나요? OpsIQ 일반 API에 어떻게 인증하나요? OpsIQ 일반 API를 통해 사용할 수 있는 작업은 몇 가지인가요?…
2,483
왜 내 API 토큰 비밀을 다시 볼 수 없나요?
토큰 비밀은 생성 시점에만 의도적으로 표시됩니다. 계정은 향후 토큰 사용을 검증하는 데 필요한 정보를 저장하며, 나중에 표시할 수 있는 재사용 가능한 일반 텍스트 복사본은 저장하지 않습니다. 비밀을 잃어버리면, 교체 토큰을 생성하고 잃어버린 토큰을 비활성화하거나 삭제해야 합니다. 관련 기사 OpsIQ의 아웃바운드 웹훅은 어떻게 서명되나요? OpsIQ 일반 API에 어떻게 인증하나요?…
2,461
OpsIQ 일반 API에 어떻게 인증하나요?
OpsIQ 일반 API에 인증하기 OpsIQ의 일반 API는 범위가 지정된 Bearer API 키를 사용합니다. 이러한 키는 기능에 필요한 최소 권한 범위만 할당되는 것이 중요합니다. 또한, 이 키는 비밀로 안전하게 저장되어야 하며 공개 브라우저 코드나 저장소에 포함되어서는 안 됩니다. 개발자 사이트에서는 다음에 대한 자세한 정보를 제공합니다: 62개의 사용 가능한 범위 공통 API 진입점…
2,406
API 토큰을 삭제하면 무엇이 발생하나요?
토큰을 삭제하면 해당 고객 토큰이 활성 사용에서 영구적으로 제거됩니다. 여전히 구성된 통합은 인증을 중지하며, 접근이 여전히 필요하다면 새로운 토큰으로 업데이트해야 합니다. 영구 제거 대신 되돌릴 수 있는 일시 중지를 원하신다면, 먼저 토큰을 비활성화하세요. 관련 기사 OpsIQ의 아웃바운드 웹훅은 어떻게 서명되나요? OpsIQ 일반 API에 어떻게 인증하나요? OpsIQ 일반 API를…
2,392
OpsIQ에서 고객 API 토큰이란 무엇인가요?
고객 API 토큰은 계정 비밀번호를 공유하지 않고도 지원되는 고객 범위 통합을 인증할 수 있게 해줍니다. 이러한 토큰은 토큰이 생성될 때 제공되는 범위에 따라 지원되는 계정, 라이센스, 청구 또는 지원 작업에 대한 제한된 권한을 가질 수 있습니다. 통합에 실제로 필요한 권한만 부여하는 것이 중요합니다. 관련 기사 OpsIQ의 아웃바운드 웹훅은 어떻게 서명되나요? OpsIQ 일반 API에…
2,370
OpsIQ 고객 API 토큰을 어떻게 생성하나요?
OpsIQ 고객 API 토큰을 생성하려면 다음 단계를 따르세요: API 토큰 섹션을 엽니다. 설명적인 이름으로 토큰을 생성합니다. 적절한 사용 가능한 권한을 선택합니다. 토큰이 생성된 후, 비밀을 즉시 복사하고 안전하게 저장하세요. 전체 비밀은 한 번만 표시됩니다. OpsIQ는 검증 목적으로 보호된 표현을 유지하며, 나중에 원래 비밀을 다시 표시하지 않습니다. 관련 기사 OpsIQ의…
2,314
통합을 위해 계정 비밀번호 대신 OpsIQ API 토큰을 사용할 수 있나요?
예, 지원되는 고객 API 작업을 위해 계정 비밀번호 대신 OpsIQ API 토큰을 사용할 수 있습니다. 이 방법은 상호작용 계정 비밀번호와의 통합을 제공하는 것보다 바람직합니다. 왜냐하면 토큰은 이름을 지정하고, 범위를 설정하고, 모니터링하고, 비활성화하고, 독립적으로 교체할 수 있기 때문입니다. 토큰을 비밀로 유지하고 브라우저 URL, 티켓 및 로그에 포함하지 않는 것이 중요합니다…
1,951
아직 도움이 필요하신가요?

찾고 있는 것을 찾을 수 없다면 저희 팀이 도와드리겠습니다.

지원팀에 문의