이용안내

미니톡 이용과 관련된 도움말을 제공합니다.
에러코드별 문제해결하기

미니톡 클라이언트 및 미니톡 채팅위젯에서는 몇가지 에러에 대하여 에러코드를 발생시키고 있습니다.

이 문서에는 각 에러코드별 원인 및 해결방법에 대하여 설명합니다.


에러코드 100번대

에러코드 100번대는 사용자 닉네임과 관련된 에러를 의미합니다.


에러코드
원인 및 해결방법
100

닉네임에 허용되지 않는 문자가 포함되어 있거나, 닉네임의 최대허용길이를 초과합니다.

닉네임에는 일부특수문자(#, @, ", ')및 공백이 허용되지 않으며, 닉네임의 최대길이는 30자까지만 지원합니다.

유저코드생성시 위의 규칙을 만족하는 닉네임으로 설정된 유저코드를 생성 후 사용해보시기 바랍니다.

101
닉네임이 중복된 경우 발생합니다. 기존에 중복된 닉네임으로 접속된 사용자의 접속이 끊어지게 되며, 이는 정상동작범위입니다.
102닉네임이 중복된 경우 발생합니다. 기존에 중복된 닉네임으로 접속된 사용자의 접속이 해제되면 자동으로 재접속하게 됩니다.
103닉네임 변경이 허용되지 않는 채널에서 닉네임 변경을 시도할 때 발생합니다.
104이미 사용중인 닉네임으로 변경을 시도하는 경우 발생합니다.



에러코드 400번대

에러코드 400번대는 권한문제 및 요청된 데이터에 오류가 있을 경우 발생합니다.


에러코드
원인 및 해결방법
403

특정 요청에 대한 권한이 없을 경우 발생합니다.

채널설정 등에 설정된 권한을 다시 한번 확인해보시고, 권한이 있는 레벨의 유저코드를 사용하고 있는지 확인해보시기 바랍니다.

404

특정 요청에 대한 대상 데이터가 없을 경우 발생합니다.

잠시후 다시 시도하거나, 요청하는 대상(닉네임 대상, 호출대상 등)이 존재하는지 다시 확인해보시기 바랍니다.


410이미 채널관리자 권한을 가진 상태에서 채널 관리자 권한을 획득하려고 할 때 발생합니다.
411채널설정에 설정된 채널 패스워드가 일치하지 않는 경우입니다.
412유저코드를 통해 이미 채널 관리자권한을 획득한 경우 /logout 명령으로 채널관리자 권한을 해지할 수 없습니다.



에러코드 800번대

에러코드 800번대는 개인박스와 관련된 오류가 있을 경우 발생합니다.


에러코드
원인 및 해결방법
800

개인박스를 개설하는 동안 오류가 발생한 경우로 대부분의 경우 다시 개인박스개설을 시도할 경우 문제없이 개설이 됩니다.

801비공개 개인박스(패스워드가 설정된 개인박스)에 패스워드 없이 접속을 시도하는 경우 발생합니다.
802비공개 개인박스(패스워드가 설정된 개인박스)에 패스워드가 일치하지 않는 경우 발생합니다.
803

개인박스를 개설할 권한이 없음에도 개인박스를 개설하고자 시도할 때 발생합니다.

개인박스 개설권한은 미니톡 클라이언트 관리자 채널관리에서 설정할 수 있습니다.

804

존재하지 않는 개인박스에 접속을 시도할 때 발생합니다.

개인박스 개설자가 접속을 종료하여 개인박스가 존재하지 않을 경우 발생할 수 있습니다.

899개인박스에 접속하고 있던 도중 개인박스를 개설한 사용자가 접속을 중단하였을 경우, 해당 개인박스가 종료되며 접속중인 모든 유저의 접속이 종료될 때 발생합니다.



에러코드 900번대

에러코드 900번대는 서버 접속과 관련된 오류가 있을 경우 발생합니다.


에러코드
원인 및 해결방법
900

서버접속에 필요한 필수정보가 누락되었을 경우 발생합니다.

미니톡 클라이언트를 수정하지 않았다면 발생하지 않는 문제로, 미니톡 클라이언트를 수정하였다면, 원래 배포된 파일로 복구 후 시도해보시기 바랍니다.

901

서버접속에 필요하지 않은 불필요한 데이터와 함께 서버접속을 시도할 경우 발생합니다.

서버접속시 특정 데이터를 함께 전달하고자 하는 경우에는 유저코드생성시 $extras=array() 값에 해당 정보를 설정하시기 바랍니다.

그 외의 방법으로 추가 데이터가 전달되는 경우 접속이 차단됩니다.

902

서버접속코드를 확인할 수 없는 경우 발생합니다. 일반적인 경우에는 발생하지 않으며 미니톡 클라이언트를 수정하였다면 원래 배포된 파일로 복구 후 시도해보시기 바랍니다.

미니톡 클라이언트 설치시 생성되는 /configs/key.config.php 파일을 임의로 수정하신 경우 미니톡 클라이언트를 재설치한 뒤 시도해보시기 바랍니다.

903

서버접속코드가 만료된 경우 발생합니다.

채팅호스팅 서비스를 받고 있는 경우에 간헐적으로 발생할 수 있으며, 채팅호스팅 연결이 불완전할 때 발생할 수 있습니다.

채팅호스팅 서비스 매뉴얼을 참고하여 미니톡 클라이언트 관리자에서 채팅호스팅 연결을 다시 확인하신 후 시도해보시기 바랍니다.

904

채널접속코드를 확인할 수 없을 때 발생합니다. 일반적인 경우에는 발생하지 않으며 미니톡 클라이언트를 수정하였다면 원래 배포된 파일로 복구 후 시도해보시기 바랍니다.

미니톡 클라이언트 설치시 생성되는 /configs/key.config.php 파일을 임의로 수정하신 경우 미니톡 클라이언트를 재설치한 뒤 시도해보시기 바랍니다.

910

유저접속코드를 확인할 수 없을 때 발생합니다.

유저코드생성시 미니톡 클라이언트 설치시 입력한 암호화키가 아닌 다른 문자열로 유저코드가 생성되었거나, 유저코드생성함수가 잘못된 경우 발생합니다.

유저코드생성하는 매뉴얼을 참고하여 정상적인 방법으로 유저코드를 생성 후 시도해보시기 바랍니다.

911

유저의 IP를 확인할 수 없는 경우 발생합니다.

유저코드 생성시 미니톡 클라이언트가 설치된 웹서버에서 파악한 유저의 IP 정보가 포함됩니다.

해당 IP정보와 미니톡 서버에 접속하는 유저의 IP가 다른경우 발생합니다.

미니톡 서버는 IPv4 만을 지원하며, 웹서버가 IPv6 를 지원할 경우 유저코드에 포함된 IP가 IPv6 로 기록되어 발생할 수 있습니다.

필수적으로 IPv6 가 필요한 경우가 아닌경우, 웹서버의 IPv6 지원을 끄고 IPv4 만 지원하도록 설정함으로써 해결할 수 있습니다.

또는 클라우드플레어나 L4 장비등과 같이 미니톡 클라이언트가 설치된 웹서버에서 유저의 실제 IP 가 아닌, 클라우드플레어 IP 또는 L4 장비의 IP가 유저코드에 기록되는 경우에도 발생할 수 있습니다.

미니톡 클라이언트의 /classes/functions.php 파일내에 GetClientIp() 함수가 존재하는데, 이 함수의 리턴값이 유저의 실제 IP인지 확인해보시기 바랍니다. 

유저의 실제 IP 가 아닌 다른 IP가 출력된다면, 사용하시는 웹서버에서 유저의 실제 IP를 확인할 수 있는 변수($_SERVER['HTTP_X_FORWARDED_FOR'] 등) 을 이용하여 유저의 실제 IP 가 유저코드에 기록될 수 있도록 수정하여 주시기 바랍니다.

912

생성된 유저코드내에 포함된 유저데이터 중 누락된 데이터가 있는 경우 발생합니다.

유저코드에는 nickname, nickcon, photo, level, extras, ip 값이 필수적으로 존재하여야 합니다.

유저코드 생성방법에 대한 매뉴얼을 확인하신 후 정상적인 유저코드를 생성하여 시도해보시기 바랍니다.

913

유저데이터에 nickname, nickcon, photo, level, extras, ip 값 외에 다른 데이터가 존재할 경우 발생합니다.

유저데이터에 추가적인 데이터를 기록해야하는 경우 extras 값에만 추가할 수 있으며, 다른 방법으로 추가된 데이터가 존재할 경우 서버접속이 차단됩니다.

914유저닉네임이 잘못 정의된 경우 발생합니다. CODE 100 에 설명된 닉네임 규칙에 따라 닉네임을 설정하신 후 생성된 유저코드로 접속을 시도해보시기 바랍니다.
915유저코드생성시 닉네임에 NULL 을 입력하여 닉네임이 정의되지 않은 상태에서, 유저의 레벨을 1이상으로 설정하는 경우 발생합니다. 유저레벨을 1이상으로 설정하려면 반드시 고정된 닉네임이 필요합니다.
916유저코드생성시 닉네임에 NULL 이 아닌 고정된 닉네임을 설정하고, 유저레벨을 0으로 설정하는 경우 발생합니다. 고정닉네임이 존재하는 경우 유저레벨은 반드시 1레벨 이상으로 설정되어야 합니다.
917유저코드생성시 입력한 유저의 레벨이 허용범위(0~9)를 벗어날 경우 발생합니다.  웹사이트 상에서 회원의 권한레벨이 0~9 범위를 벗어날 경우, 웹사이트 상의 회원레벨을 미니톡 레벨범위(0~9)에 맞도록 적절하게 수정하여 주셔야 합니다.
예를 들어 관리자권한의 웹사이트 상의 회원레벨이 10 인 경우, 미니톡 관리자 레벨 9 로 수정하여 주셔야 합니다.
918유저코드 생성시 입력한 닉이미지 경로 또는 회원 프로필사진 경로가 문자열이 아닌 경우에 발생합니다. 해당부분에 적절한 이미지 URL 이 입력되었는지 확인해보시기 바랍니다.
919유저코드 생성시 입력한 유저의 추가정보가 배열 또는 객체가 아닌 경우 발생합니다. 유저의 추가정보는 배열 또는 객체로 정의되어야 합니다.
최종수정일 :