텔레그램 api_id·api_hash 발급 — my.telegram.org 에서 받고 지키기

api_id·api_hash 는 무엇인가

텔레그램 API 나 TDLib 으로 사람 계정 앱을 만들려면 api_id(숫자)와 api_hash(긴 문자열) 한 쌍이 필요합니다. 내 앱이 어떤 앱인지 텔레그램 서버에 밝히는 이름표입니다. 봇만 만든다면 필요 없습니다 — 봇은 @BotFather 의 토큰 하나로 됩니다(API 4가지 고르기).

항목	내용
받는 곳	my.telegram.org 의 API development tools
필요한 것	텔레그램에 가입한 전화번호와, 그 계정이 로그인된 텔레그램 앱
개수	전화번호 하나에 api_id 하나
값	api_id 는 숫자, api_hash 는 영문·숫자로 된 긴 문자열

받는 순서

1. PC 브라우저로 my.telegram.org 에 들어가 가입한 전화번호를 국제 형식으로 적습니다. 한국 번호는 +82 뒤에 맨 앞 0 을 빼고 씁니다.

2. Next 를 누르면 확인 코드가 문자가 아니라 텔레그램 앱으로 옵니다(화면 문구). 휴대폰이나 PC 의 텔레그램에서 파란 인증 표시가 붙은 Telegram 공식 알림 대화를 열면 영문·숫자가 섞인 코드가 와 있습니다.

이 코드는 앱 로그인 코드와 달리 계정 삭제까지 할 수 있는 코드입니다. 메시지에 적힌 대로 텔레그램 직원이라고 하는 사람이 물어도 알려 주지 않고, 내가 요청하지 않았는데 왔다면 무시합니다.

3. 코드를 적고 Sign In 을 누릅니다. 공용 PC 라면 Remember Me 는 켜지 않습니다.

4. 로그인한 첫 화면(Your Telegram Core)에서 API development tools 를 엽니다. 바로 아래 Delete account 는 계정 삭제이니 누르지 않습니다.

5. 처음이면 앱 정보를 적는 양식이 나옵니다. 앱 이름(App title)과 짧은 이름(Short name, 영문·숫자 5~32자)을 채워 보내면 api_id 와 api_hash 가 생깁니다. 이미 만든 적이 있으면 양식 대신 아래처럼 그 앱의 App configuration 화면이 바로 열립니다.

같은 화면 아래쪽에는 시험용(Test configuration)과 실제(Production configuration) MTProto 서버 주소, 그 서버의 공개 키가 나옵니다. 라이브러리를 쓰면 직접 넣을 일이 거의 없고, 개발 중에 실제 계정 대신 시험 서버에서 돌려 볼 때 씁니다.

받은 값 지키기

api_id·api_hash 와 내 전화번호 로그인이 합쳐지면 그 프로그램은 내 계정 그대로 움직입니다. 그래서 값은 비밀번호처럼 다룹니다.

• 코드 안에 직접 적지 않고 환경 변수나 설정 파일에 두며, 그 파일은 코드 저장소에 올리지 않습니다.
• 남이 만든 프로그램에 내 값을 넣어 달라는 요청은 거절합니다. 값과 함께 로그인 코드까지 넘기면 계정을 넘기는 것과 같습니다.
• 공개 프로그램을 배포할 때는 반드시 내가 받은 값을 씁니다. 오픈 소스 예제에 들어 있는 견본 값은 시험용이라 요청 수가 크게 묶여 있고, 그대로 배포하면 API_ID_PUBLISHED_FLOOD 오류가 납니다.

다음 단계

하려는 것	글
값으로 앱 만들기	TDLib 이란
계정이 막히지 않게	API 이용 약관
봇이면 충분한지 보기	API 4가지 고르기