Skip to content

Releases

v0.7.0

Choose a tag to compare

@leegunwoooo leegunwoooo released this 09 Nov 05:57

추가

  • Spine 애니메이션 자산 URL (전캐릭터·코스튬별 stand/aim/cover) + GET /api/nikkes/:id/spine + MCP get_nikke_spine
  • 버스트 컷신 카탈로그·재생 뷰어 (/burst-viewer) + GET /api/nikkes/:id/burst + MCP get_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

Choose a tag to compare

@leegunwoooo leegunwoooo released this 30 Oct 01:35

Changes since v0.4.0

Features

  • /api/user/:blablaid/roster — bulk upstream-shaped roster endpoint
  • /api/events — story-event catalog
  • nikke details: attractiveScenarios linked 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

Choose a tag to compare

@leegunwoooo leegunwoooo released this 01 Oct 01:34

⚠️ 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

Choose a tag to compare

@leegunwoooo leegunwoooo released this 01 Oct 00:04

What's Changed

New

  • /api/costumes/:id — 이름(전 언어, 부분 일치)으로도 조회 가능. 단일 매칭 시 상세, 복수 매칭 시 목록 반환 (2c333d3)
  • /api/equips / /api/equips/:id — stats·optionSlots·costs·description 필드 추가 (c0bbc5f)

Fixed

  • /api/equips 500 — 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

Choose a tag to compare

@leegunwoooo leegunwoooo released this 30 Sep 05:49

What's Changed

New

  • ?page=N page-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/cubes lazyIndex 적용

Full Changelog: v0.2.0...v0.2.1

v0.2.0

Choose a tag to compare

@leegunwoooo leegunwoooo released this 30 Sep 05:29

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

Choose a tag to compare

@leegunwoooo leegunwoooo released this 30 Sep 01:39

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

Choose a tag to compare

@leegunwoooo leegunwoooo released this 30 Sep 23:44

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

Choose a tag to compare

@leegunwoooo leegunwoooo released this 29 Sep 23:36

변경점

API

  • 유저 식별 파라미터를 blablaid로 통일 — /api/user/:blablaid, ?blablaid= (구형 ?openid=·?url= 호환 유지)
  • 에러 메시지 invalid openid → invalid blablaid
  • 소장품 skills[].unlocksAt 추가 — 전용 소장품 스킬 해금 단계(1·2·3) 표시, 해금 순 정렬

인프라

  • 데이터 동기화 fetch 재시도 추가 — CDN 일시 장애 시 배포 중단 해결

문서

  • 니케 상세 이름 부분 일치 설명 정리

v0.1.0

Choose a tag to compare

@leegunwoooo leegunwoooo released this 29 Sep 06:52

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