인증

모든 요청은 Authorization: Bearer 헤더 하나로 인증합니다. 인증 정보를 사용할 때는 Access Key와 Secret Key를 콜론으로 연결하세요. 인증 정보는 콘솔의 Credentials 페이지에서 만듭니다.

curl https://api.justdeploy.net/ping \
  -H "Authorization: Bearer YOUR_ACCESS_KEY:YOUR_SECRET_KEY"

기존 X-Access-Key 및 X-Secret-Key 헤더도 계속 작동합니다. 이 헤더를 이미 사용 중인 앱은 새로 빌드할 필요가 없습니다. 새로 작성하는 코드에는 단일 헤더를 사용하세요.

"pong"

MCP로 연결된 AI 도구도 같은 헤더를 사용하지만 MCP 로그인에서 발급된 사용자 범위 토큰을 보냅니다. 이 토큰에는 콜론이 없습니다. MCP 클라이언트가 자동으로 처리하므로 직접 만들거나 붙여넣을 것은 없으며, 토큰은 고객이 속한 모든 조직에 사용할 수 있습니다.

{
  "organizations": [
    {
      "id": "org_...",
      "name": "My Organization",
      "role": null
    }
  ]
}

키의 허용 범위

키마다 허용된 작업 범위(scope)가 다르며 API가 요청마다 이를 검사합니다. 콘솔에서 만든 인증 정보와 DEPLOY.md의 키는 조직의 전체 JustDeploy API를 사용할 수 있는 배포 범위입니다. 실행 중인 앱에 발급하는 런타임 키는 앱에 필요한 작업만 허용합니다.

• 배포 범위: 전체 API, 빌드, 가이드, 테이블, 환경 변수, 방화벽 규칙, 스케줄러, 로그, 지표, 런타임 키 발급.
• 런타임 범위: 앱에 필요한 범위만 허용합니다. 데이터베이스 행 읽기·쓰기, 파일 업로드·다운로드, 데이터베이스·스토리지 목록 조회, 자신의 프로젝트 환경 변수·방화벽 규칙 읽기가 가능합니다. 테이블 변경, 환경 변수 쓰기, 빌드 시작, 가이드 가져오기, 키 발급은 할 수 없습니다.

런타임 키는 발급받은 프로젝트에서만 사용할 수 있습니다. 같은 조직의 다른 프로젝트에 사용해도 403이 반환됩니다.

프로젝트 DEPLOY.md의 배포 키도 해당 프로젝트 관리에만 사용할 수 있습니다. 다른 프로젝트를 관리하려고 하면 403이 반환됩니다. 데이터베이스, 스토리지, 이메일 작업은 계속 조직 전체에서 사용할 수 있으며, 조직 DEPLOY.md의 키에는 프로젝트 제한이 없습니다.

프로젝트는 지정된 관리 멤버만 배포하도록 제한할 수 있습니다. 관리 멤버가 아닌 사람이 빌드 생성, 재빌드, 재배포를 요청하면 담당자 이름과 함께 403이 반환됩니다. Owner 같은 조직 역할도 예외가 아닙니다. 조직 전체 인증 정보는 발급한 사람과 관계없이 거부되며, 로그인 사용자나 MCP 토큰은 해당 사용자가 관리 멤버로 선택된 경우에만 허용됩니다. 같은 인증 정보로 다시 시도해도 성공하지 않습니다. 해당 프로젝트의 DEPLOY.md를 사용하거나 관리 멤버 계정으로 작업하세요. 관리 멤버 설정은 모든 조직 멤버가 콘솔에서 변경할 수 있지만 API로는 바꿀 수 없습니다.

앱용 키 발급

배포 범위 키 또는 Bearer 토큰이 필요합니다. 먼저 프로젝트 환경 변수를 확인하세요. 이미 키가 등록되어 있다면 새로 발급하지 말고 재사용하세요.

{
  "credential": {
    "id": 12,
    "access": "ak_...",
    "secret": "sk_...",
    "description": "Runtime key for project prj_...",
    "expiredAt": null,
    "createdAt": "2026-07-27T00:00:00.000Z"
  }
}