giip

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>"

요청 파라미터

이름위치필수설명
csnquery✅조회할 프로젝트 번호. 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가 사용하는 것)

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

상태 → 고양이 행동 매핑

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

status고양이 상태이미지 파일 패턴
PENDINGplaying/images/catquest/<cat>_playing.png
READYready/images/catquest/<cat>_ready.png
IN_PROGRESShunting/images/catquest/<cat>_hunting.png
REVIEWdelivering/images/catquest/<cat>_delivering.png
DONEplaying/images/catquest/<cat>_playing.png
  • <cat> 은 isn % 8 로 8종(mochi·sherlock·nimbus·pixel·cocoa·midnight·luna·leo) 중 하나가 고정 배정됩니다.

관련 API

  • 이슈 등록·수정·상태변경: 프로그램으로 이슈를 생성/전이하려면 이슈 및 태스크 API 를 참조하세요.
  • 코멘트 조회/추가: 이슈 상세 화면은 giipIssueComments API를 사용합니다.

문제 해결

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

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

← PreviousIssue CatQuestNext →SES Proposals Admin