maplestory/backend/routes/character.js
caadiq 3829ada3cf Nexon API 점검중 상태 감지/표시
- 백엔드: notices/character 라우트에서 OPENAPI00001/00007/00010/00011
  응답을 감지해 503 + { maintenance: true, code } 반환
- 프론트 api 클라이언트가 에러에 서버 필드(maintenance 등)를 병합
- 공지 위젯: 점검중이면 "넥슨 Open API 점검중" 안내 + retry 차단
- 캐릭터 검색 오류 메시지로 '점검중' 상황이 "존재하지 않는 캐릭터"와 구분

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-16 08:45:50 +09:00

81 lines
3 KiB
JavaScript

import { Router } from 'express';
import axios from 'axios';
const router = Router();
const NEXON_API_BASE = 'https://open.api.nexon.com';
// 캐릭터 닉네임으로 정보 조회
router.get('/search', async (req, res) => {
const { name } = req.query;
if (!name?.trim()) return res.status(400).json({ error: '캐릭터 닉네임을 입력해주세요' });
try {
// 1) ocid 조회
const { data: idData } = await axios.get(`${NEXON_API_BASE}/maplestory/v1/id`, {
params: { character_name: name.trim() },
headers: { 'x-nxopen-api-key': process.env.NEXON_API_KEY },
});
// 2) basic 조회
const { data: basic } = await axios.get(`${NEXON_API_BASE}/maplestory/v1/character/basic`, {
params: { ocid: idData.ocid },
headers: { 'x-nxopen-api-key': process.env.NEXON_API_KEY },
});
res.json({
ocid: idData.ocid,
character_name: basic.character_name,
world_name: basic.world_name,
job_name: basic.character_class,
character_level: basic.character_level,
character_image: basic.character_image,
});
} catch (err) {
const code = err.response?.data?.error?.name;
if (['OPENAPI00001', 'OPENAPI00007', 'OPENAPI00010', 'OPENAPI00011'].includes(code)) {
return res.status(503).json({ error: 'API 점검중입니다', code, maintenance: true });
}
if (err.response?.status === 400) {
return res.status(404).json({ error: '존재하지 않는 캐릭터입니다' });
}
console.error('캐릭터 조회 오류:', err.response?.data || err.message);
res.status(500).json({ error: '캐릭터 조회 실패' });
}
});
// OCID로 장착 심볼 조회
router.get('/symbols', async (req, res) => {
const { ocid } = req.query;
if (!ocid) return res.status(400).json({ error: 'ocid가 필요합니다' });
try {
const { data } = await axios.get(`${NEXON_API_BASE}/maplestory/v1/character/symbol-equipment`, {
params: { ocid },
headers: { 'x-nxopen-api-key': process.env.NEXON_API_KEY },
});
const parsed = (data.symbol || []).map((s) => {
const [prefix, region] = (s.symbol_name || '').split(' : ').map((t) => t.trim());
const type = prefix?.replace(/심볼$/, '').trim(); // '아케인심볼' → '아케인'
return {
type,
region,
level: Number(s.symbol_level) || 0,
force: Number(s.symbol_force) || 0,
growth_count: Number(s.symbol_growth_count) || 0,
require_growth_count: Number(s.symbol_require_growth_count) || 0,
};
});
res.json({ ocid, character_class: data.character_class, symbols: parsed });
} catch (err) {
const code = err.response?.data?.error?.name;
if (['OPENAPI00001', 'OPENAPI00007', 'OPENAPI00010', 'OPENAPI00011'].includes(code)) {
return res.status(503).json({ error: 'API 점검중입니다', code, maintenance: true });
}
console.error('심볼 조회 오류:', err.response?.data || err.message);
res.status(500).json({ error: '심볼 조회 실패' });
}
});
export default router;