프로젝트 및 서비스 관리 API 가이드 (v1.2)

GIIP 플랫폼 내의 조직(프로젝트)과 서비스 그룹을 관리하기 위한 API 명세입니다.

🔌 프로젝트 목록 기능 페이지로 이동 →

📋 개요

프로젝트(고객) 및 서비스 그룹 API는 GIIP 인프라를 논리적 단위로 구분하고 권한을 제어하는 핵심 기능을 제공합니다.

🔐 인증 및 보안

• Header: 공통 인증 헤더 필수
• 권한: 프로젝트 생성/삭제는 높은 등급의 관리자 권한이 요구될 수 있습니다.

📡 API 상세

1. 프로젝트 관리

프로젝트 목록 조회 (PrjList)

• 명령:

  text=PrjList

• 설명: 현재 사용자가 접근 가능한 모든 프로젝트(고객) 목록을 반환합니다.
• 반환예시:

  [{"csn":44, "cname":"Acme Corp"}, ...]

프로젝트 신규 등록 (PrjPut)

• 명령:

  text=PrjPut <cCode>, '<cName>'

• 파라미터:

  • cCode

    : 프로젝트 영문 코드 (Unique)

  • cName

    : 프로젝트 표시 명칭
• 예시:

  text=PrjPut GIIP_DEV, 'GIIP 개발팀'

프로젝트 삭제 (PrjDel)

• 명령:

  text=PrjDel <CSN>

• 예시:

  text=PrjDel 44

2. 서비스 그룹(Project Group) 관리

서비스 목록 조회 (PrjGrpList)

• 명령:

  text=PrjGrpList <CSN>

• 설명: 특정 프로젝트 하위의 서비스 그룹(cgCode 기반) 목록을 조회합니다.

서비스 등록/수정 (PrjGrpPut)

• 명령:

  text=PrjGrpPut '<CgCode>', <cSn>, '<cgName>', '<cgDesc>'

• 예시:

  text=PrjGrpPut 'WEB', 44, 'Web Service', 'Primary web application group'

🛡️ Sk3(고성능 로깅) 활용

신규 프로젝트 등록이나 서비스 그룹 수정과 같이 인프라 전반의 구조에 영향을 주는 관리 작업 시, 작업의 정합성 확보와 상세한 감사 로그(Audit Log)를 위해

giipApiSk3

엔드포인트를 권장합니다.

• 엔드포인트:

  https://giipfaw.azurewebsites.net/api/giipApiSk3

• 장점: 프로젝트 생성 실패 시 호출자의 상세 환경 정보(IP, UA)와 StackTrace를 즉시 기록하여 설정 오류나 권한 이슈를 신속하게 분석할 수 있습니다.
• 활용 팁:

  text

  명령과

  jsondata

  의 파라미터 치환 기능을 활용하여 복잡한 서비스 그룹 설명이나 한글 명칭 등을 유실 없이 안전하게 관리하십시오.

---

버전: 1.3 최종 업데이트: 2026-04-10 소스 파일:

giipv3/public/help/api-project-user.ko.md

---

관련 문서:

• API 결과 코드 가이드 (RstVal)