프로젝트 관리 API

최근 업데이트 2026. 10. 03.

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

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

1. 유저 프로젝트 목록

주의

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

인터페이스 URL

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

요청 방식

POST

Content-Type

application/json

요청 Query 파라미터

파라미터 이름	예시 값	파라미터 타입	필수 여부	파라미터 설명
token	xxx	String	예	조회 키
loginName	test007	String	예	로그인 이름

성공 응답 예시

{
    "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.companyId	1	Integer	회사 ID
data.projectId	2	Integer	프로젝트 ID
data.projectName	제품 내부 테스트 프로젝트	String	프로젝트 이름
data.projectType	0	Integer	프로젝트 타입 0: 일반 프로젝트 1: 중국어 DEMO 프로젝트 2: 영어 DEMO 프로젝트
data.remark	-	String	프로젝트 메모
data.roleName	root	String	역할 이름
return_code	0	Integer	반환 코드
return_message	success	String	반환 정보

오류 응답 예시

{
    "return_code": -1999,
    "return_message": "유효하지 않은 유저"
}

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

---

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

주의

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

인터페이스 URL

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

요청 방식

POST

Content-Type

application/json

요청 Query 파라미터

파라미터 이름	예시 값	파라미터 타입	필수 여부	파라미터 설명
token	xxx	String	예	조회 키
projectId	2	Integer	예	프로젝트 ID

요청 Body 파라미터

{
    "projectName": "새 프로젝트 이름"
}

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

성공 응답 예시

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

파라미터 이름	예시 값	파라미터 타입	파라미터 설명
return_code	0	Integer	반환 코드
return_message	success	String	반환 정보

오류 응답 예시

{
    "return_code": -1006,
    "return_message": "작업 권한이 없습니다. token 값이 올바른지 확인하십시오"
}

파라미터 이름	예시 값	파라미터 타입	파라미터 설명
return_code	-1006	Integer	반환 코드
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 파라미터

파라미터 이름	예시 값	파라미터 타입	필수 여부	파라미터 설명
token	xxx	String	예	조회 키
projectName	test007	String	예	프로젝트 이름
loadHistory	1	Integer	예	과거 데이터 가져오기 모드 사용 여부 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.appid	2ec39af5e0db4be2a1371b44a7cbedc5	String	appid
data.projectId	2535	Integer	프로젝트 ID
return_code	0	Integer	반환 코드
return_message	success	String	반환 정보

오류 응답 예시

{
    "return_code": -1015,
    "return_message": "test007이 이미 존재합니다"
}

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