Skip to main content
공개 API는 Failproof AI 대시보드 오리진의 /v1 경로에서 제공됩니다.

​
키 생성 및 요청 보내기

  1. Administration → Keys를 열고 Create key를 선택한 후, 해당 통합에 필요한 최소 권한 프리셋을 선택하세요.
  2. 필요한 경우에만 개별 권한을 추가하고, 키를 생성한 뒤 일회성 시크릿을 복사하세요.
  3. /v1/sessions에 테스트 요청을 보내고 Keys 페이지에서 키가 활성 상태인지 확인하세요.
  4. 통합의 소유권이 변경될 경우 액션 메뉴에서 키를 교체하거나 비활성화하세요. 권한 프리셋과 개별 권한이 표시된 새 API 키 생성 패널.
위에 키 생성 패널이 표시되어 있습니다. 일회성 시크릿은 create를 선택한 후에만 표시되므로, 확인 창을 닫기 전에 반드시 복사해 두세요.
키는 조직과 권한 세트에 종속됩니다. 엔드포인트에 필요한 권한이 없는 요청은 403을 반환하며, 누락된 권한 정보를 함께 알려줍니다.

​
조직 선택

조직 키는 해당 조직에 자동으로 적용됩니다. 인스턴스 범위 키는 요청별로 조직을 선택할 수 있습니다:
Administration → Keys를 열기 전에 대시보드 헤더의 조직 전환기를 사용하세요. 해당 위치에서 생성된 키는 선택된 조직에 속합니다. 자격 증명을 자동화에 복사하기 전에 URL과 키 상세 정보에서 조직 슬러그를 확인하세요.
현재 경로, 파라미터, 권한 요구사항, 상태 코드는 이 섹션의 엔드포인트 페이지를 참고하세요. 명세는 서버 라우트 어노테이션에서 생성되며 /v1 라우터에 대해 검증됩니다. 현재 명세는 라우트, 메서드, 파라미터, 권한, 상태 코드를 완전히 커버합니다. 일부 응답 본문은 서버가 여전히 동적 JSON으로 구성하기 때문에 의도적으로 타입이 지정되지 않은 상태입니다. 응답 스키마가 없는 엔드포인트를 기반으로 강타입 클라이언트를 생성하기 전에 실제 응답을 직접 확인하세요. JSON 쓰기 요청에는 Content-Type: application/json을 사용하세요. 401은 인증 정보 누락 또는 유효하지 않은 인증을, 403은 유효한 신원이지만 필요한 권한 부재를, 404는 존재하지 않거나 조직에서 접근할 수 없는 리소스를, 409는 상태 충돌을, 422는 유효하지 않은 필드 또는 권한 값을 의미합니다. 오류 응답에는 사람이 읽을 수 있는 메시지가 포함되며, 권한 실패 시에는 필요한 권한도 함께 표시됩니다.
정책 적용 배포는 의도적으로 일반 공개 /v1 인터페이스 밖에서 관리됩니다. 지원되는 Cloud 배포 워크플로를 사용하세요.