API
인증
워크스페이스 키로 Mandavo API에 인증하고, 이를 통해 범위 지정 에이전트 자격 증명을 발급하세요.
워크스페이스 키
신원 생성, 정책 작성, 자격 증명 발급과 같은 관리자 호출은 워크스페이스 키로 인증합니다. 설정에서 하나를 생성하고 Authorization 헤더에 베어러 토큰으로 전송하세요.
워크스페이스 키는 여러분의 백엔드 전용입니다. 에이전트에게 전달되는 일은 절대 없으며, 에이전트는 여러분이 발급하는 단기 자격 증명으로 행동합니다.
기본 URL과 버전 관리
모든 요청은 https://api.mandavo.com으로 전송되며 /v1로 시작하는 경로 접두사로 버전이 관리됩니다. 호환성을 깨는 변경은 새 접두사로 출시되고, 추가적인 변경은 그렇지 않습니다.
요청과 응답은 JSON입니다. 본문이 있는 모든 요청에 Content-Type: application/json을 보내세요.
에이전트 자격 증명
에이전트가 행동하도록 하려면, 발급 엔진을 통해 워크스페이스 키를 범위 지정 자격 증명으로 교환한 뒤, 그 단기 토큰만 에이전트에게 전달하세요. 토큰은 신원, 범위, 만료 시간을 담습니다.
에이전트 자격 증명은 단일 작업용이며 메모리에만 존재해야 합니다. 저장하지 말고, 다음 작업을 위해 새로 요청하세요.
오류
API는 표준 HTTP 상태 코드를 사용합니다. 401은 키가 없거나 유효하지 않음을, 403은 행동이 호출자의 범위를 벗어났거나 정책에 의해 거부되었음을, 429는 속도 제한에 걸렸음을 의미합니다. 오류 본문에는 기계가 읽을 수 있는 코드와 사람이 읽을 수 있는 메시지가 포함됩니다.