실제 적용 흐름이 궁금하신가요?

이용 시나리오 / 캐릭터 정보 활용하기

캐릭터

이해하기

스토브 플랫폼의 캐릭터 서비스를 연동하면 게임의 캐릭터 정보를 플랫폼에 저장하고, 커뮤니티·고객센터·이벤트 등 다양한 스토브 서비스에서 활용할 수 있어요.
연동하지 않으면 일부 또는 전체 기능 사용에 제약이 생길 수 있어요.

캐릭터 기능

사용처 예시

1) 커뮤니티

스토브 대표 닉네임이 기본으로 표시되지만, 캐릭터 서비스를 연동하면 게임 닉네임을 자유롭게 지정하고 노출할 수 있어요.
(노출처: 모바일 인게임, PC 웹, 스토브 앱, 온라인 타임라인 등)

사용 시 — 모바일(인게임)

사용 시 — PC(웹)

미사용 시 — 모바일(인게임)

(스토브 플랫폼 닉네임이 노출되며, 닉네임을 설정하지 않은 경우 스토브91136027과 같은 자동 발급 ID가 기본값으로 노출돼요.)

미사용 시 — PC(웹)

2) 고객센터

[고객센터] > [문의하기] > [게임 정보]에서 월드와 캐릭터 정보를 직접 선택할 수 있어요.
캐릭터 서비스를 연동하지 않으면 해당 항목이 빈 공백으로 표시돼요.

사용 시

미사용 시

3) 파트너스

고객 CS 문의가 접수되면 스토브 파트너스의 회원 정보 관리에서 게임별 캐릭터 상세 정보를 확인할 수 있어요.
캐릭터 서비스를 연동하지 않으면 빈 공백으로 표시돼요.

사용 시

연동 가이드

제공 기능

연동 준비

해지·탈퇴 시 캐릭터 처리

게임 해지 또는 스토브 회원 탈퇴가 발생하면 캐릭터 정보 처리 방식이 달라져요.

개발하기

게임 캐릭터를 스토브 플랫폼과 연동하는 방법을 설명해요. 각 API의 요청/응답 파라미터 상세 스펙은 API 문서를 참고하세요.

사전 준비

정책 및 입력 규칙

캐릭터 기능을 연동하기 전에, 캐릭터 닉네임 정책과 입력 규칙을 확인해주세요.

캐릭터 닉네임 입력 규칙

스토브 플랫폼은 아래의 캐릭터 닉네임 입력 규칙을 검증해요. 캐릭터 닉네임 등록 전 반드시 확인해 주세요.

캐릭터 닉네임 중복 체크

플랫폼의 캐릭터 닉네임 중복 체크 기능을 사용하는 경우, 캐릭터 등록/변경 시 중복된 닉네임은 허용되지 않아요. 플랫폼 캐릭터 닉네임 중복 체크 기능을 사용하려는 경우, 어떤 타입의 중복 체크를 사용할지 퍼블리싱 기술 담당자에게 전달해주세요.

※ 스토브 플랫폼은 기본적으로 캐릭터 닉네임 중복 체크를 하지 않아요. 닉네임 중복 체크는 게임에서 직접 처리하는 것을 권장합니다.

닉네임 전달 시 유의 사항

스토브 플랫폼에 캐릭터 닉네임을 전달할 때는 이용자가 입력한 값을 그대로 전달해야 해요. 인게임에서 캐릭터 닉네임에 난수값, Prefix, Suffix 등을 사용하더라도, 스토브 플랫폼에는 이용자가 입력한 캐릭터 닉네임을 그대로 전달해야 해요. 그렇지 않은 경우, 캐릭터 닉네임 기반으로 동작하는 스토브 플랫폼 기능이 정상 동작하지 않을 수 있어요.

개발 흐름

게임에서 캐릭터가 생성되면 해당 캐릭터 정보를 스토브 플랫폼에 동기화해야 해요. 동기화가 완료되면 스토브는 해당 캐릭터를 식별하기 위한 캐릭터 고유 번호(character_no)를 발급해요.

게임 캐릭터 정보(닉네임 또는 월드)가 변경되면 스토브 플랫폼에도 동기화해야 해요.

3-1. 캐릭터 삭제

게임에서 캐릭터가 삭제되면 스토브 캐릭터 정보도 함께 삭제해요.

3-2. 캐릭터 복구

게임에서 삭제 유예 기간 내 복구 기능을 제공한다면, 스토브 플랫폼에 캐릭터를 재등록해 처리해야 해요.

트러블슈팅

캐릭터 닉네임이 중복된 경우

(플랫폼의 캐릭터 닉네임 중복 체크 기능을 사용 중인 게임에서) 캐릭터 닉네임이 플랫폼에서 중복된 경우에 발생할 수 있어요. 이용자가 다른 닉네임으로 재시도할 수 있도록 처리해주세요.

{
  "code": 78608,
  "message": "Nickname already exists."
}

게임 또는 월드 정보가 확인되지 않을 때

요청한 game_id 또는 world_id가 스토브 플랫폼에서 확인되지 않는 경우 발생해요.

{
  "code": 78603,
  "message": "Game not found."
}

아래 순서로 확인해보세요.

1. API Access Token의 게임 정보가 정상인지 확인하세요. (퍼블리싱 기술 담당자에게 문의)
2. 사용 중인 game_id가 발급받은 값과 일치하는지 확인하세요.
3. 파트너스에 월드 정보가 등록되어 있는지, 등록된 world_id를 사용하고 있는지 확인하세요.

캐릭터 정보가 확인되지 않을 때

요청한 character_no가 스토브 플랫폼에서 확인되지 않는 경우 발생해요.

{
  "code": 78610,
  "message": "The character data does not exist."
}

게임 서버에 저장된 character_no가 올바른지 확인하세요. 잘못된 값이 저장되고 있지 않은지 점검하세요.

비정상 응답일 때

네트워크 오류나 서버 장애 등으로 인해 API가 정상적으로 동작하지 않는 경우에 대해 대응되어야 해요.

• ① API 문서에 정의되지 않은 응답 코드가 내려오는 경우
• ② API 응답 자체가 없는 경우
  ①, ②의 경우는 모두 실패로 간주하고 처리해야 해요.

자주 묻는 질문