@lumir-company/admin-server-api

@lumir-company/admin-server-api

관리자 시스템을 위한 API SDK 패키지입니다.

설치

npm install @lumir-company/admin-server-api

사용법

인증

import { AuthAPI } from '@lumir-company/admin-server-api';

const authApi = new AuthAPI('http://your-api-url');

// 로그인
const token = await authApi.login({
    accountId: 'your-id',
    password: 'your-password',
});

공지사항 관리

import { NoticeAPI } from '@lumir-company/admin-server-api';

const noticeApi = new NoticeAPI('http://your-api-url');
noticeApi.setToken(token.accessToken);

// 공지사항 목록 조회
const { data } = await noticeApi.getNotices(1, 10);

// 공지사항 상세 조회
const notice = await noticeApi.getNoticeById('notice-id');

뉴스 관리

import { NewsAPI } from '@lumir-company/admin-server-api';

const newsApi = new NewsAPI('http://your-api-url');
newsApi.setToken(token.accessToken);

// 뉴스 목록 조회
const { data } = await newsApi.getNews(1, 10);

// 뉴스 상세 조회
const news = await newsApi.getNewsById('news-id');

보도자료 관리

import { PressReleaseAPI } from '@lumir-company/admin-server-api';

const pressReleaseApi = new PressReleaseAPI('http://your-api-url');
pressReleaseApi.setToken(token.accessToken);

// 보도자료 목록 조회
const { data } = await pressReleaseApi.getPressReleases(1, 10);

// 보도자료 상세 조회
const pressRelease =
    await pressReleaseApi.getPressReleaseById('press-release-id');

S3 파일 관리

import { S3API } from '@lumir-company/admin-server-api';

const s3Api = new S3API('http://your-api-url');
s3Api.setToken(token.accessToken);

// 파일 다운로드
const fileResponse = await s3Api.getFile('file-key', true);

페이지뷰 추적

import { PageViewAPI, PageName } from '@lumir-company/admin-server-api';

export enum PageName {
    MAIN = '메인 페이지',
    DISCLOSURE = '전자공고',
    SHAREHOLDER = '주주정보',
    NEWS = '루미르스토리',
    VIDEO = '영상',
    BROCHURE = '정보자료',
}

const pageViewApi = new PageViewAPI('http://your-api-url');

// 페이지 진입 시 기록
await pageViewApi.createPageView({
    sessionId: 'user-session-id',
    pageName: PageName.MAIN,
    enterTime: new Date(),
    url: 'https://lumir.space/',
});

// 페이지 이탈 시 업데이트
await pageViewApi.updatePageView({
    sessionId: 'user-session-id',
    pageName: PageName.MAIN,
    exitTime: new Date(),
    stayDuration: 60000, // 밀리초 단위
});

API 레퍼런스

AuthAPI

• login({ accountId, password }): 로그인하여 토큰을 반환

NoticeAPI

• setToken(token): API 요청에 사용할 토큰 설정
• getNotices(page, limit): 공지사항 목록 조회
• getNoticeById(id): 특정 공지사항 조회

NewsAPI

• setToken(token): API 요청에 사용할 토큰 설정
• getNews(page, limit): 뉴스 목록 조회
• getNewsById(id): 특정 뉴스 조회

PressReleaseAPI

• setToken(token): API 요청에 사용할 토큰 설정
• getPressReleases(page, limit): 보도자료 목록 조회
• getPressReleaseById(id): 특정 보도자료 조회

S3API

• setToken(token): API 요청에 사용할 토큰 설정
• getFile(key, download): 파일 다운로드/조회

PageViewAPI

• createPageView(data): 페이지뷰 데이터 생성
• updatePageView(data): 페이지뷰 데이터 업데이트 (종료 시간 및 체류 시간)