API 레퍼런스

JustDeploy를 직접 호출하는 개발자와 AI 에이전트를 위한 문서입니다. 코딩 AI로 만든다면 보통 이 문서가 필요하지 않습니다. MCP로 연결하면 AI가 이 호출을 대신 실행합니다.

JustDeploy API를 사용하면 코드나 외부 시스템에서 데이터베이스, 테이블, 배포 작업을 자동화할 수 있습니다.

기본 URLhttps://api.justdeploy.net

인증Access Key와 Secret Key를 콜론으로 연결한 값을 Authorization: Bearer 헤더에 넣거나 MCP 로그인에서 받은 개인 액세스 토큰을 사용합니다.

응답 형식{ "resource": { ... } } 단일 자원은 위 형식을 사용하고 목록은 { "resources": [ ... ] } 형식을 사용합니다.

오류 형식오류는 { "status", "message", "requestId" } 형식으로 반환됩니다. 데이터베이스나 서비스의 일시적인 문제에는 503과 함께 retryAfter에 대기할 초가 표시됩니다. 해당 시간만큼 기다린 뒤 같은 요청을 다시 보내세요. retryAfter가 없다면 재시도하기 전에 메시지에서 다음 행동을 확인하세요. 문제를 신고할 때는 X-Request-Id로도 반환되는 requestId를 함께 알려주세요.

요청 제한조직당 초당 최대 100개의 요청을 보낼 수 있습니다. 모든 응답에 X-RateLimit-Limit과 X-RateLimit-Remaining이 포함됩니다. 제한을 넘으면 429와 함께 오류의 retryAfter 필드와 Retry-After 헤더에 대기할 초가 반환됩니다.