에러코드별 문제해결하기

미니톡 클라이언트 및 미니톡 채팅위젯에서는 몇가지 에러에 대하여 에러코드를 발생시키고 있습니다.
이 문서에는 각 에러코드별 원인 및 해결방법에 대하여 설명합니다.

에러코드 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	서버접속코드가 만료된 경우 발생합니다. 채팅호스팅 서비스를 받고 있는 경우에 간헐적으로 발생할 수 있으며, 채팅호스팅 연결이 불완전할 때 발생할 수 있습니다. 채팅호스팅 서비스 매뉴얼을 참고하여 미니톡 클라이언트 관리자에서 채팅호스팅 연결을 다시 확인하신 후 시도해보시기 바랍니다. v8.2.1 이상에서는 903, 911 에러가 발생하면 접속정보를 새로 받아 최대 3회(2초, 5초, 10초 후) 자동으로 다시 접속합니다.
904	채널접속코드를 확인할 수 없을 때 발생합니다. 일반적인 경우에는 발생하지 않으며 미니톡 클라이언트를 수정하였다면 원래 배포된 파일로 복구 후 시도해보시기 바랍니다. 미니톡 클라이언트 설치시 생성되는 /configs/key.config.php 파일을 임의로 수정하신 경우 미니톡 클라이언트를 재설치한 뒤 시도해보시기 바랍니다.
909	유저접속코드의 유효기간이 지난 경우 발생합니다. (v8.x) 발급시각(iat)이 포함된 유저코드는 채팅서버에 설정된 유효기간(기본 7일)이 지나면 사용할 수 없습니다. 페이지를 새로고침하여 새 유저코드를 받으면 해결되며, 유저코드가 포함된 페이지가 캐시되고 있다면 캐시 설정을 확인하여 주시기 바랍니다.
910	유저접속코드를 확인할 수 없을 때 발생합니다. 유저코드생성시 미니톡 클라이언트 설치시 입력한 암호화키가 아닌 다른 문자열로 유저코드가 생성되었거나, 유저코드생성함수가 잘못된 경우 발생합니다. 유저코드생성하는 매뉴얼을 참고하여 정상적인 방법으로 유저코드를 생성 후 시도해보시기 바랍니다.
911	유저의 IP를 확인할 수 없는 경우 발생합니다. 유저코드 생성시 미니톡 클라이언트가 설치된 웹서버에서 파악한 유저의 IP 정보가 포함됩니다. 해당 IP정보와 미니톡 서버에 접속하는 유저의 IP가 다른경우 발생합니다. v8.x 에서는 발급시각(iat)이 포함된 일반 유저코드는 IP가 달라도 접속이 허용되며, 발급시각이 없는 유저코드나 최고관리자(레벨 9) 유저코드는 IP가 다르면 이 에러가 발생합니다. 웹서버와 미니톡 서버에 IPv4 와 IPv6 가 섞여 있는 경우에도 유저코드에 기록된 IP와 접속 IP가 달라 발생할 수 있습니다. 또는 클라우드플레어나 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 값(v8.x 서버는 iat 포함) 외에 다른 데이터가 존재할 경우 발생합니다. v8.2.1 미만 서버나 채팅호스팅에 발급시각(iat)이 포함된 유저코드로 접속하는 경우에도 발생합니다. 유저데이터에 추가적인 데이터를 기록해야하는 경우 extras 값에만 추가할 수 있으며, 다른 방법으로 추가된 데이터가 존재할 경우 서버접속이 차단됩니다.
914	유저닉네임이 잘못 정의된 경우 발생합니다. CODE 100 에 설명된 닉네임 규칙에 따라 닉네임을 설정하신 후 생성된 유저코드로 접속을 시도해보시기 바랍니다.
915	유저코드생성시 닉네임에 NULL 을 입력하여 닉네임이 정의되지 않은 상태에서, 유저의 레벨을 1이상으로 설정하는 경우 발생합니다. 유저레벨을 1이상으로 설정하려면 반드시 고정된 닉네임이 필요합니다.
916	유저코드생성시 닉네임에 NULL 이 아닌 고정된 닉네임을 설정하고, 유저레벨을 0으로 설정하는 경우 발생합니다. 고정닉네임이 존재하는 경우 유저레벨은 반드시 1레벨 이상으로 설정되어야 합니다.
917	유저코드생성시 입력한 유저의 레벨이 허용범위(0~9)를 벗어날 경우 발생합니다. 웹사이트 상에서 회원의 권한레벨이 0~9 범위를 벗어날 경우, 웹사이트 상의 회원레벨을 미니톡 레벨범위(0~9)에 맞도록 적절하게 수정하여 주셔야 합니다. 예를 들어 관리자권한의 웹사이트 상의 회원레벨이 10 인 경우, 미니톡 관리자 레벨 9 로 수정하여 주셔야 합니다.
918	유저코드 생성시 입력한 닉이미지 경로 또는 회원 프로필사진 경로가 문자열이 아닌 경우에 발생합니다. 해당부분에 적절한 이미지 URL 이 입력되었는지 확인해보시기 바랍니다.
919	유저코드 생성시 입력한 유저의 추가정보가 배열 또는 객체가 아닌 경우 발생합니다. 유저의 추가정보는 배열 또는 객체로 정의되어야 합니다.