더 자세한 개발 가이드가 필요하신가요?

캐릭터 정보 활용하기

스토브 가입

스토브 로그인

기기등록

게임진입

결제

기타설정

게임해지

스토브 탈퇴

서비스 소개

이용자는 게임에서 쓰던 캐릭터를 스토브 커뮤니티와 고객센터에서도 그대로 활용할 수 있어요. 커뮤니티에서는 게임 닉네임으로 활동하고, 고객센터에 문의할 때는 캐릭터 정보가 자동으로 채워져 일일이 입력하지 않아도 돼요. 게임사가 캐릭터 정보를 스토브에 전달하면 이런 편의를 제공할 수 있어요.

항목	내용
연동 대상 정보	캐릭터 닉네임, 월드(서버) 정보
지원 환경	멀티플랫폼(Mobile·PC)
연동 시 활성화 서비스	커뮤니티 게임 닉네임 표시, 고객센터 캐릭터 자동 선택, 파트너스 캐릭터 정보 조회

핵심개념

용어	설명	비고
캐릭터	이용자 계정에 귀속된 게임 캐릭터	닉네임·월드 정보를 스토브에 등록
월드	게임의 서버·채널 구분 단위	파트너스에서 월드 정보(world_id, 월드명)로 사전 등록 (예: world_kr)
API 토큰	캐릭터 API 호출용 서버 간 인증 토큰	퍼블리싱 기술 담당자를 통해 사전 발급

이용 시나리오

커뮤니티 닉네임 표시

이용자는 스토브 커뮤니티에서 스토브 기본 ID 대신 게임 캐릭터 닉네임으로 활동할 수 있어요. 게임사가 캐릭터 정보를 전달하면 닉네임이 바로 표시돼요.

항목	내용
노출 정보	게임 캐릭터 닉네임
노출 위치	모바일 인게임 커뮤니티, PC 웹, 스토브 앱, 온라인 타임라인
필요 연동	STOVE 캐릭터 등록/변경 API
호출 시점	캐릭터 닉네임 등록/변경 시점
미연동 시 노출	스토브 플랫폼 닉네임 노출 (미설정 시 STOVE91136027 등 자동 발급 ID가 기본값)

고객센터 캐릭터 연동

이용자가 게임 내 고객센터에서 문의할 때, 드롭다운에 캐릭터 정보가 자동으로 표시돼요. 캐릭터 이름·서버를 직접 입력하지 않아도 되고, 운영팀도 파트너스에서 문의자의 캐릭터 정보를 바로 확인할 수 있어요.

대상	위치	내용
이용자	고객센터 > 문의하기 > 게임 정보	월드(서버)·캐릭터 선택 드롭다운 자동 활성화 미연동 시 빈 공백으로 표시 — 이용자가 직접 입력 필요
운영팀 (파트너스)	파트너스 > CS > 회원 관리 > 회원 정보 관리	문의 접수 시 캐릭터 번호·닉네임·월드 정보 확인 가능 미연동 시 캐릭터 정보 미노출

이건 꼭 알아 두세요
파트너스 특정 메뉴에서 월드 정보가 불러와지지 않는다면 파트너스 계정의 월드 접근 권한을 확인해 주세요.
파트너스 > Account > 권한 관리 > 필드 권한에서 전체 월드 권한을 요청할 수 있어요.

연동개요

전체 적용 흐름

단계	담당 · 활동	상세 내용
1단계	게임사 기획팀 적용 범위 결정	활용 서비스 범위·월드 구성·닉네임 중복 체크 기능 사용 여부를 결정해 퍼블리싱 기술 담당자에게 전달
2단계	게임사 기획팀 · 퍼블리싱 담당자 사전 준비	1) API Access Token 발급 요청 (퍼블리싱 기술 담당자) 2) 파트너스에 월드 정보(world_id, 월드명) 등록
3단계	게임사 개발팀 서버 연동	캐릭터 정보 동기화 위한 STOVE API 호출 로직 구현
4단계	게임사 기획팀 서비스 설정	파트너스 CS 캐릭터 조회 권한 확인
5단계	게임사 QA팀 검증 및 배포	체크리스트로 필수·권장 항목 점검 후 Sandbox(샌드박스) → Live 순서로 검증·배포

시작 전 결정 항목

캐릭터 연동을 시작하기 전, 아래 항목을 게임팀 내부에서 먼저 결정해 주세요.

결정 항목	선택지 및 내용	결정 후 처리
① 활용 서비스 범위 결정	캐릭터 연동을 통해 활성화할 서비스 선택 커뮤니티: 게임 닉네임 노출 고객센터: 문의 시 캐릭터 드롭다운 자동 표시	활용할 서비스 목록 확정 후 개발팀에 전달
② 월드(서버) 구성 결정	게임의 서버·채널 구조에 맞게 월드 정보(world_id, 월드명) 정의 world_id는 공백 포함 불가 서비스 국가·환경(Sandbox/Live)별로 구분 등록 필요 예: world_kr, world_global, world_jp	world_id 목록 확정 후 파트너스에 직접 등록
③ 닉네임 중복 체크 기능 사용 여부 결정	닉네임 중복 체크 기능 사용 여부 결정 (닉네임 등록/변경 시 기능 동작함.) ❶ 중복 체크하지 않음. (기본값) ❷ 게임 내 닉네임 중복 불가 ❸ 월드 내 중복 허용 불가(게임 내 닉네임 중복은 허용) ※ STOVE 플랫폼은 기본적으로 캐릭터 닉네임 중복 체크를 하지 않아요. 닉네임 중복 체크는 게임에서 직접 처리하는 것을 권장하며, 플랫폼 중복 체크 기능은 게임에서 처리하기 어려운 경우에만 사용해 주세요.	닉네임 중복 체크 기능 사용 여부 결정 후, 퍼블리싱 기술 담당자에게 전달 (기본값을 사용하는 경우에는 전달하지 않아도 됨.)

역할 분담

캐릭터 연동 서비스에서 스토브가 처리하는 영역과 게임사가 직접 구현하는 영역을 구분하면 개발팀과 소통하기 수월해요.

스토브 플랫폼이 제공하는 것4개

캐릭터 등록·조회·변경·삭제 ·복구 API

커뮤니티 캐릭터 닉네임 노출 처리

고객센터 캐릭터 선택 드롭다운 표시

파트너스 CS 문의자 캐릭터 정보 표시

게임사가 구현해야 하는 것3개

파트너스에 월드 정보(world_id, 월드명) 사전 등록

게임 캐릭터 생성/변경 시, 스토브 캐릭터 API 호출을 통한 캐릭터 정보 동기화 구현

환경 구분 안내

연동 테스트는 반드시 Sandbox(샌드박스) 환경에서 먼저 진행한 뒤, 검증이 완료된 후 Live 환경에 적용해요.

구분	Sandbox (샌드박스)	Live (운영)
API Host	https://api.gate8.com	https://api.onstove.com
웹 / 플랫폼	https://www.gate8.com	https://www.onstove.com
용도	개발·QA 테스트 전용. 실 이용자에게 영향 없음	실제 서비스 환경. QA 완료 후 배포

체크리스트

구분	역할	점검항목
필수	게임 서버	API Access Token 발급 완료 퍼블리싱 기술 담당자에게 API Access Token 발급 요청 완료 확인
필수	게임 서버	캐릭터 등록 API 정상 동작 확인 STOVE 캐릭터 등록 API 정상 호출 및 캐릭터 고유 번호(character_no) 발급 확인 발급된 캐릭터 고유 번호(character_no)가 게임 내 캐릭터와 매핑하여 저장되었는지 확인
필수	게임 서버	캐릭터 정보 변경 및 삭제 API 정상 동작 확인 게임 내 캐릭터 정보 변경 항목에 대한 STOVE API 정상 호출 확인
필수	게임 서버	API 호출 실패 케이스 처리 확인 스토브 API 호출 실패 시 재시도·예외 처리 로직 구현 확인
필수	게임 클라이언트	파트너스 world_id 등록 완료 파트너스에 world_id 등록 확인 Sandbox/Live 환경 각각 등록 여부 확인

더 자세한 개발 가이드가 필요하신가요? 기능별 가이드 / 캐릭터

기술지원이 필요하신가요? MCP 사용 가이드

직접 문의하고 싶으신가요? stove.developers@smilegate.com