본문으로 건너뛰기

프로젝트 관리 API

최근 업데이트 2026. 11. 12.

호출 방법은 Open API 문서의 호출 방법 설명을 참고하십시오.

프로젝트 관리 관련 기능을 이해하려면 먼저 AE 사용 설명서를 읽어 보는 것이 좋습니다: 프로젝트 관리

1. 유저 프로젝트 목록​

주의

로그인 이름으로 해당 유저의 프로젝트 목록을 가져옵니다

인터페이스 URL

/open/project-list?token=xxx&loginName=test007

요청 방식

POST

Content-Type

application/json

요청 Query 파라미터

파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
tokenxxxString예조회 키
loginNametest007String예로그인 이름

성공 응답 예시

{
"data": [
{
"companyId": 1,
"projectId": 2,
"projectName": "제품 내부 테스트 프로젝트",
"projectType": 0,
"remark": "",
"roleName": "root"
},
{
"companyId": 1,
"projectId": 6,
"projectName": "thinkinggame 공식 사이트 운영",
"projectType": 0,
"remark": "",
"roleName": "root"
}
],
"return_code": 0,
"return_message": "success"
}
파라미터 이름예시 값파라미터 타입파라미터 설명
data-Object반환 데이터
data.companyId1Integer회사 ID
data.projectId2Integer프로젝트 ID
data.projectName제품 내부 테스트 프로젝트String프로젝트 이름
data.projectType0Integer

프로젝트 타입

  • 0: 일반 프로젝트
  • 1: 중국어 DEMO 프로젝트
  • 2: 영어 DEMO 프로젝트
data.remark-String프로젝트 메모
data.roleNamerootString역할 이름
return_code0Integer반환 코드
return_messagesuccessString반환 정보

오류 응답 예시

{
"return_code": -1999,
"return_message": "유효하지 않은 유저"
}
파라미터 이름예시 값파라미터 타입파라미터 설명
return_code-1999Integer반환 코드
return_message유효하지 않은 유저String반환 정보

2. 프로젝트 정보 업데이트​

주의

프로젝트 정보를 업데이트합니다. 현재는 프로젝트 이름 업데이트만 지원합니다

인터페이스 URL

/open/project/update-project-info?token=xxx&projectId=2

요청 방식

POST

Content-Type

application/json

요청 Query 파라미터

파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
tokenxxxString예조회 키
projectId2Integer예프로젝트 ID

요청 Body 파라미터

{
"projectName": "새 프로젝트 이름"
}
파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
projectName새 프로젝트 이름String예프로젝트 이름

성공 응답 예시

{
"return_code": 0,
"return_message": "success"
}
파라미터 이름예시 값파라미터 타입파라미터 설명
return_code0Integer반환 코드
return_messagesuccessString반환 정보

오류 응답 예시

{
"return_code": -1006,
"return_message": "작업 권한이 없습니다. token 값이 올바른지 확인하십시오"
}
파라미터 이름예시 값파라미터 타입파라미터 설명
return_code-1006Integer반환 코드
return_message작업 권한이 없습니다. token 값이 올바른지 확인하십시오String반환 정보

3. 새 프로젝트 생성 및 appId 생성​

주의
  • 프로젝트 이름이 이미 존재하는지 확인하며, 존재하면 생성에 실패하고 오류 응답 예시와 같은 결과를 반환합니다

인터페이스 URL

/open/project/generate-project-app-id?token=xxx&projectName=test007&loadHistory=1

요청 방식

POST

Content-Type

application/json

요청 Query 파라미터

파라미터 이름예시 값파라미터 타입필수 여부파라미터 설명
tokenxxxString예조회 키
projectNametest007String예프로젝트 이름
loadHistory1Integer예

과거 데이터 가져오기 모드 사용 여부

  • 0: 끄기
  • 1: 켜기

curl 예시

curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' 'http://ta2:8992/open/project/generate-project-app-id?token=YOUR_TOKEN&projectName=test1222&loadHistory=1'

성공 응답 예시

{
"data": {
"appid": "2ec39af5e0db4be2a1371b44a7cbedc5",
"projectId": 2535
},
"return_code": 0,
"return_message": "success"
}
파라미터 이름예시 값파라미터 타입파라미터 설명
data-Object반환 데이터
data.appid2ec39af5e0db4be2a1371b44a7cbedc5Stringappid
data.projectId2535Integer프로젝트 ID
return_code0Integer반환 코드
return_messagesuccessString반환 정보

오류 응답 예시

{
"return_code": -1015,
"return_message": "test007이 이미 존재합니다"
}
파라미터 이름예시 값파라미터 타입파라미터 설명
return_code-1015Integer반환 코드
return_messagetest007이 이미 존재합니다String반환 정보

4. 계정 일괄 생성 및 단일 프로젝트 분석 역할 설정​

단일 프로젝트의 계정을 일괄 생성하고 구성원을 추가하며 분석 역할을 전체 설정합니다. 같은 요청에서 해당 프로젝트의 데이터 권한도 지정할 수 있습니다. 프로젝트 토큰으로 계정, 역할, 데이터 권한을 동기화하는 프라이빗 배포 환경용 API이며 SaaS는 지원하지 않습니다.

호출 조건

대상 프로젝트의 프로젝트 토큰 또는 해당 프로젝트가 속한 회사의 회사 토큰을 사용합니다. 사용자 토큰, 임시 토큰, 다른 프로젝트나 회사의 토큰은 사용할 수 없습니다. 토큰 발급 방법과 서비스 주소는 이 페이지 시작 부분에 연결된 Open API 호출 안내를 참조하세요.

POST /open/batch-set-project-roles?token=<TOKEN>
Content-Type: application/json

Query 파라미터 token을 생략하고 Authorization: Bearer <TOKEN> 요청 헤더를 사용할 수도 있습니다. Content-Type은 application/json입니다.

요청 Body 파라미터

파라미터타입필수설명
authUsersArray예계정 목록입니다. 빈 목록이나 null 요소는 허용되지 않습니다.
authUsers[].loginNameString예로그인 계정 이름입니다. 형식은 유저 일괄 생성 API와 같습니다. 한 요청에서 중복될 수 없으며 대소문자만 다른 이름도 중복으로 처리합니다.
authUsers[].rolesArray예대상 프로젝트에서 해당 계정에 설정할 전체 분석 역할 목록입니다. 빈 목록이나 null 요소는 허용되지 않습니다.
authUsers[].roles[].projectIdInteger예실제로 존재하는 0 이상의 프로젝트 ID입니다. 요청 내 모든 계정과 모든 역할의 projectId가 같아야 합니다. Query 파라미터에 projectId를 별도로 전달할 필요는 없습니다.
authUsers[].roles[].roleDescString예대상 프로젝트에서 사용 가능한 기존 분석 역할의 표시 이름입니다. 내부 식별자가 아니며 빈 값은 허용되지 않습니다. 중복 역할은 하나로 처리합니다.
authUsers[].dataPowersArray아니요해당 계정의 데이터 권한 설정입니다. 생략, null, 빈 배열은 모두 기존 데이터 권한을 유지합니다. 새 계정이나 새로 프로젝트에 참여하는 계정에 권한을 지정하지 않으면 기본 전체 데이터 권한을 사용합니다. 배열 요소는 null일 수 없습니다.
authUsers[].dataPowers[].projectIdInteger예해당 계정의 roles에 지정한 대상 프로젝트 ID와 같아야 합니다. 같은 계정에 같은 프로젝트를 중복 설정할 수 없습니다.
authUsers[].dataPowers[].dataPowerNameString둘 중 하나프로젝트에 이미 존재하는 사용자 정의 데이터 권한의 원래 전체 이름입니다. 정확히 일치하는 설정이 하나만 있어야 합니다. 내부 ID를 전달하지 않으며 유사 검색이나 자동 생성은 지원하지 않습니다. 전체 데이터를 뜻하는 이름도 사용자 정의 권한으로 해석합니다. 이름을 선택할 때 allData는 생략하거나 null로 설정하세요.
authUsers[].dataPowers[].allDataBoolean둘 중 하나허용되는 값은 true뿐이며 요청 언어와 관계없이 전체 데이터 권한을 명시적으로 부여합니다. 이때 dataPowerName은 생략하거나 null로 설정하세요. false, 공백 이름, 둘 다 미지정, 둘 다 지정은 모두 거부됩니다.

요청 예시

다음 예시는 프로젝트 57의 두 계정에 전체 분석 역할을 설정하고 api_user_1에는 사용자 정의 데이터 권한을, api_user_2에는 전체 데이터 권한을 명시적으로 부여합니다. API Analyst, API Viewer, API Data Scope는 예시 이름이므로 대상 프로젝트에 이미 존재하는 역할 및 데이터 권한 이름으로 바꿔 사용하세요. 역할만 설정하려면 dataPowers를 생략할 수 있습니다.

{
"authUsers": [
{
"loginName": "api_user_1",
"roles": [
{
"projectId": 57,
"roleDesc": "API Analyst"
},
{
"projectId": 57,
"roleDesc": "API Viewer"
}
],
"dataPowers": [
{
"projectId": 57,
"dataPowerName": "API Data Scope"
}
]
},
{
"loginName": "api_user_2",
"roles": [
{
"projectId": 57,
"roleDesc": "API Viewer"
}
],
"dataPowers": [
{
"projectId": 57,
"allData": true
}
]
}
]
}

처리 규칙

  • 계정이 없으면 대상 프로젝트가 속한 회사에 계정을 생성하며 초기 비밀번호는 ta2020입니다. 기존 계정이 프로젝트에 참여하지 않은 경우 멤버로 추가합니다. 새로 참여한 멤버는 기본 사용자 그룹에 추가됩니다.
  • 기존 멤버의 대상 프로젝트 분석 역할은 추가가 아니라 전체 교체됩니다. 예를 들어 기존 역할이 A와 B이고 이번 요청에 B만 포함하면 성공 후에는 B만 남습니다. 유지할 역할 전체를 매번 전달해야 합니다. 빈 목록으로 멤버를 제거할 수는 없습니다.
  • 이번에 명시한 대상 프로젝트의 데이터 권한만 변경합니다. dataPowers 생략, null, 빈 배열은 모두 기존 데이터 권한을 유지합니다. 사용자 정의 권한 이름이 없거나 중복되거나 다른 프로젝트에만 존재하면 배치 전체가 실패하며 전체 데이터 권한으로 대체하지 않습니다. 다른 프로젝트 및 플랫폼의 역할, 비밀번호, 잠금 상태는 변경하지 않습니다. 회사 설정에서 프로젝트 내 계정 생성을 비활성화한 경우 새 계정은 생성할 수 없지만 기존 계정의 역할은 설정할 수 있습니다.
  • 슈퍼 관리자, 프로젝트 소유자, 시스템 관리자 등 보호된 권한은 부여할 수 없습니다. 대상 회사나 프로젝트에서 이러한 권한을 가진 계정도 변경할 수 없습니다. 다른 회사의 계정, 삭제된 계정, 다른 프로젝트·회사·플랫폼의 역할은 거부됩니다.
  • 배치 전체를 한 번에 처리합니다. 파라미터, 권한, 역할 또는 데이터 권한 검증에 실패하면 어떤 변경도 적용하지 않습니다. 쓰기 중 실패하면 계정, 역할, 기본 그룹, 데이터 권한을 함께 롤백하며 일부 성공 결과는 반환하지 않습니다.
  • 이전 요청이 성공적으로 완료된 후 동일한 요청을 다시 보내면 기존 계정을 재사용하여 같은 역할을 설정합니다. 계정이 중복 생성되거나 역할이 누적되지 않습니다. 같은 프로젝트의 배치는 순서대로 호출하세요. 동시 요청의 실행 순서나 최종 역할 집합은 보장하지 않습니다.

응답

성공 응답 예시:

{
"return_code": 0,
"return_message": "success"
}

return_code가 0이면 성공이며, 그 외의 값은 실패를 나타냅니다. return_message에 오류 정보가 반환됩니다. 주요 실패 원인은 비어 있거나 중복된 파라미터, 여러 프로젝트의 혼합, 토큰 권한 부족, 사용할 수 없는 역할, 다른 회사의 계정이나 삭제된 계정 지정, 보호된 권한을 가진 계정 변경 시도입니다.

이 문서가 도움이 되었나요?