Repository navigation
Releases
Releases · leegunwoooo/nikke-api
v0.7.0
추가
- Spine 애니메이션 자산 URL (전캐릭터·코스튬별 stand/aim/cover) +
GET /api/nikkes/:id/spine+ MCPget_nikke_spine - 버스트 컷신 카탈로그·재생 뷰어 (
/burst-viewer) +GET /api/nikkes/:id/burst+ MCPget_nikke_burst— 배경/캐릭터 분리 애니메이션 합성 포함 /api/tables/:file?offset&limit=페이지네이션 — 배열·{records:[]}테이블 모두{count,offset,rows}응답- MCP
api_get에tables허용 —tower_list·CharacterLevelTable·AttractiveLevelTable등 원본 테이블 조회 가능 - 유저 조회 개선: 일괄 빌드 조회, 애장품/인형 구분, 주인 필터, 정확한 이름 우선
- MARIA-n 2부 대본, 라이브러리 씬 보강
수정
- 버스트 뷰어: 배경면을 캐릭터 뒤로, 실제 버스트 트랙 재생, 스킨 적용, 버스트 보이스
- 에지 캐시 키·ETag에 번들 해시 포함 — 배포 직후 스테일 응답 방지
- 로스터: 레이트리밋 서버가 전체를 실패시키지 않도록 개선
- 스토리: 연출 마커 읽기 출력 제외, MARIA-n 1부 영상 대조 교정
- api_get 경로 검사 정규화, /api/lines 기본 limit
운영
- 데이터 파이프라인 재시도·검증·지문 강화, 배포 순서 정리
- Vercel 의존 제거, KV 쓰기 최적화
v0.5.0
Changes since v0.4.0
Features
/api/user/:blablaid/roster— bulk upstream-shaped roster endpoint/api/events— story-event catalog- nikke details:
attractiveScenarioslinked to scene groups
Fixes
- Throttle roster sweep and retry upstream rate limits (212000)
- Retry transient fetch errors in fingerprint step
- Unpaginated list requests were silently capped at 500
- Moved daily refresh off the UTC-midnight cron rush
v0.4.0
⚠️ Breaking
equipment.torso→equipment.body(/api/user/:blablaid/nikke/:nameOrId): 장비 부위 네이밍을/api/equips의slot: "body"와 통일했습니다. upstream 필드(torso_equip_*)는 그대로 읽고 응답 키만 바뀝니다 —equipment.torso를 읽던 클라이언트는equipment.body로 수정 필요 (2975048)
New
/api/costumes및/api/costumes/:id에storyScenes필드 추가 — 코스튬 사이드 스토리의 씬groupId배열./api/scenes/:groupId로 대사 조회 가능. 현재 매핑: 퍼스트 어펙션(30018)·넌센스 레드(50012) (a770940)
Fixed
- 배포본
/?version·/openapi.json이 data artifact 빌드 시점 버전을 보고하던 문제 —emit:server가 현재 package 버전을 재스탬프 (0c4f091)
Full Changelog: v0.3.0...v0.4.0
v0.3.0
What's Changed
New
/api/costumes/:id— 이름(전 언어, 부분 일치)으로도 조회 가능. 단일 매칭 시 상세, 복수 매칭 시 목록 반환 (2c333d3)/api/equips//api/equips/:id—stats·optionSlots·costs·description필드 추가 (c0bbc5f)
Fixed
/api/equips500 —ItemEquipTable이{version, records}래퍼인데 배열로 순회하던 버그 수정 (#4,d2a91b3)- 갑옷 장비 31종
slot누락 — 리소스 id가icn_equipment_body_*라torso정규식에 안 잡히던 문제 수정.body값 그대로 노출 (#4,0579000)
둘 다 @n4mm0 님이 #4에서 정확히 짚어주신 원인입니다 — 좋은 리포트 감사합니다 🙏
Docs & Infra
- 문서 누락분 보강 (
552e546) - Vercel 배포가 CDN 수천 파일 재다운로드 대신
data-latest릴리즈 artifact를 받도록 변경 — 배포 시간 단축 (e71c996)
Full Changelog: v0.2.1...v0.3.0
v0.2.1
What's Changed
New
?page=Npage-based pagination on every list endpoint (1-based;limit미지정 시 페이지 크기 50, 응답에page/totalPages) —?offset=유지/api/favorites,/api/cubes도limit/offset/page지원/api/meta/filters에stageModes/stageChapters/costumeGrades/equipClasses/equipRares/equipSlots/equipOptionRanks추가
Fixed
?url=의 malformed percent-encoding으로 500 나던 것 → 400/api/scenes?q=대소문자·공백 구분하던 것 → 다른 목록과 동일하게 무시?page=abc,?limit=abc,?offset=-5등 잘못된 페이지네이션 값 → 400 (기존엔 조용히 무시)- HEAD 요청에 ETag/Cache-Control 누락 수정
Perf
/api/stages정규화 결과 캐시,/api/cubeslazyIndex 적용
Full Changelog: v0.2.0...v0.2.1
v0.2.0
What's Changed
New
GET /api/stages+GET /api/stages/:id— 캠페인 스테이지 4,417종 (챕터/Normal·Hard·Story 모드/권장 전투력/입장·클리어 시나리오 키).?chapter=?mode=?q=필터 + 페이지네이션GET /api/costumes+GET /api/costumes/:id— 코스튬 182종 (이름·설명·등급·이미지 + 소유 니케).?q=?grade=?nikke=필터GET /api/equips+GET /api/equips/:id— 장비 124종.?q=?class=?rare=?slot=필터GET /api/equips/options+GET /api/equips/options/:id— 장비 옵션 150종/12그룹.?q=?groupId=?rank=필터GET /api/avatars+GET /api/avatars/:iconId— 아바타 아이콘 388종 (소유 캐릭터·아이콘 이미지 해석).?q=?resourceId=?orphans=필터- 유저 보유 니케 필터 분리 —
?id=(id/resourceId/nameCode 정확 일치)와?name=(전 언어 부분 일치).?q=는?name=별칭으로 유지 (하위호환) - Postman 컬렉션 전체 재생성 — 31개 요청, 11개 그룹
Fixed
?q=가 숫자 이름 니케(N102 등)를 찾지 못하던 문제 —?name=로 해결, 상세:nameOrId는 id·이름 유니온 매칭- ETag가 핸들러 실행 전 평가돼 없는 리소스도 위조 태그로 304가 나오던 문제 — 200 응답에만 304 적용
:key경로 파라미터가 무엇을 받는지 불명확 —:nameOrId로 리네임 (URL 위치 동일, 하위호환)- openapi에서
?fields=가 user-nikke 상세 경로에 문서화되지 않던 문제 ({key}잔재)
Full Changelog: v0.1.2...v0.2.0
v0.1.2
What's Changed
New
?lang=ko|en|ja|zh-TW— 모든 JSON 응답의 다국어 객체를 선택 언어 문자열로 평탄화 (누락 시 ko→en→첫 값 폴백)?fields=지원 확장 — 유저 니케 목록/상세,/api/cubes,/api/cubes/:id,/api/scenes/:groupId추가 (총 10개 엔드포인트)GET /api/nikkes에?limit=/?offset=페이지네이션 (최대 500,count는 잘라내기 전 전체 개수)
Fixed
?lang=이favorites/:id·cubes/:id·scenes/:groupId·tables/:file(파일 스트림 응답)에서 무시되던 문제/api/user/*라이브 데이터가 24시간 CDN 캐시되던 문제 — 이제no-store/openapi.json·/의 버전이 0.1.0으로 고정돼 있던 문제 — 빌드된 데이터 버전을 따라감- 없는 경로가 plain text 404를 반환하던 문제 — JSON
{"error": "not found"}로 통일
Full Changelog: v0.1.1...v0.1.2
data-latest
Rolling data bundle (data/dist tarball). Built by refresh-data workflow or manually; consumed by Vercel build via scripts/fetch-dist.mjs.
v0.1.1
변경점
API
- 유저 식별 파라미터를
blablaid로 통일 —/api/user/:blablaid,?blablaid=(구형?openid=·?url=호환 유지) - 에러 메시지
invalid openid→invalid blablaid - 소장품
skills[].unlocksAt추가 — 전용 소장품 스킬 해금 단계(1·2·3) 표시, 해금 순 정렬
인프라
- 데이터 동기화 fetch 재시도 추가 — CDN 일시 장애 시 배포 중단 해결
문서
- 니케 상세 이름 부분 일치 설명 정리
v0.1.0
BlablaLink 공식 CDN 기반 비공식 NIKKE 캐릭터 데이터 API — 라이브: https://nikke-api-gunwoos-projects.vercel.app
주요 기능
캐릭터 도감
GET /api/nikkes— 202종 목록, 이름 검색 + element/class/burst/corporation/weapon/rarity 필터GET /api/nikkes/:id— 스킬(레벨별 수치)·스탯·배경·CV·보이스·코스튬(이름 포함)·스쿼드/팀원
스토리 씬 — 3,079개
GET /api/scenes,GET /api/scenes/:groupId— 대본 + 화자 아이콘 + 한국어 보이스 mp3
소장품·하모니 큐브
GET /api/favorites,GET /api/cubes— 레벨별 스탯·스킬, 소유 니케 해석
유저 프로필 (BlablaLink 공유 링크)
GET /api/user/<openid>— 프로필·전진기지GET /api/user/<openid>/nikke— 보유 니케 목록 (도감과 동일한 필터)GET /api/user/<openid>/nikke/<key>— 보유 니케 상세 (장비 옵션 수치·큐브·소장품)
개발자 경험
- 인터랙티브 문서:
/docs(Scalar) + OpenAPI 3.1/openapi.json - Postman 컬렉션 포함
?fields=필드 선택, ETag·캐시 헤더- 데이터는 스케줄러로 주기적 동기화
비공식 팬 프로젝트 — 데이터 © SHIFT UP / Level Infinite