CatQuest 데이터 API 레퍼런스

🐾 CatQuest 페이지로 이동 →

CatQuest 화면은 **giip 이슈 목록 API(giipIssues)**를 읽어 각 이슈를 고양이 카드로 그립니다. 이 문서는 그 데이터 원천을 API로 직접 조회하는 방법과, 화면의 상태→고양이 매핑을 설명합니다.

호스트: https://giipfaw.azurewebsites.net
인증: 헤더 x-api-key 에 로그인 사용자의 AK(또는 프로젝트 스코프 SK). 조회 범위는 키의 csn(프로젝트) 로 제한됩니다.
응답 코드(RstVal) 규약은 API 결과 코드 를 참조하세요.

이슈 목록 조회 — `giipIssues` GET

CatQuest가 페이지 로드 시 호출하는 읽기 API입니다.

curl "https://giipfaw.azurewebsites.net/api/giipIssues?csn=47" \
  -H "x-api-key: <YOUR_AK>"

요청 파라미터

이름	위치	필수	설명
`csn`	query	✅	조회할 프로젝트 번호. CatQuest는 현재 선택된 프로젝트의 csn을 자동으로 넣습니다.

응답 예시

{
  "issues": [
    {
      "isn": 735,
      "title": "admin/catquest 유저 가이드 생성",
      "status": "READY",
      "regdate": "2026-07-24T08:54:00Z",
      "summary": "가이드 버튼 활성화",
      "last_comment_date": "2026-07-24T09:00:00Z",
      "blocked_by_isn": null,
      "blocked_by_title": null
    }
  ]
}

응답 필드 (CatQuest가 사용하는 것)

필드	타입	화면에서의 쓰임
`isn`	number	이슈 번호(#isn 배지). 어떤 고양이를 배정할지도 `isn`으로 결정됩니다.
`title`	string	카드 상단 말풍선 제목
`status`	string	고양이 행동(애니메이션)을 결정 — 아래 매핑표 참조
`regdate`	string	등록 일시(🐣)
`summary`	string	카드 하단 요약(있을 때만)
`last_comment_date`	string \| null	최종 코멘트 일시(💬), 없으면 "코멘트 없음"
`blocked_by_isn`	number \| null	대기(blocked-by) 배지 — 이 이슈를 막고 있는 점유 이슈 번호
`blocked_by_title`	string \| null	대기 배지의 툴팁(점유 이슈 제목)

상태 → 고양이 행동 매핑

CatQuest 프론트가 status 값을 다음 규칙으로 애니메이션에 매핑합니다(서버 값이 아니라 화면 표현 규칙).

status	고양이 상태	이미지 파일 패턴
PENDING	playing	`/images/catquest/<cat>_playing.png`
READY	ready	`/images/catquest/<cat>_ready.png`
IN_PROGRESS	hunting	`/images/catquest/<cat>_hunting.png`
REVIEW	delivering	`/images/catquest/<cat>_delivering.png`
DONE	playing	`/images/catquest/<cat>_playing.png`

<cat> 은 isn % 8 로 8종(mochi·sherlock·nimbus·pixel·cocoa·midnight·luna·leo) 중 하나가 고정 배정됩니다.

문제 해결

증상	원인	해결
`401 Unauthorized`	`x-api-key` 누락 또는 만료	유효한 AK로 다시 호출하거나 재로그인합니다.
빈 `issues: []`	해당 `csn`에 이슈가 없음	csn 값을 확인하거나 이슈를 등록합니다.
`csn` 없이 호출	필수 파라미터 누락	`?csn=<번호>` 를 반드시 포함합니다.

버전: 1.0 최종 업데이트: 2026-07-24 소스 파일: giipv3/public/help/api-catquest.ko.md

← Previous이슈 CatQuest Next →SES 제안서 관리