v10.3 메서드 185개
홈 문서 테스터 Mini App 피드백
KO

텔레그램 봇 API 문서 — Swagger·OpenAPI 3.1

Telegram Bot API Swagger는 Swagger UI로 탐색하는 대화형 텔레그램 봇 API 문서입니다. Bot API 10.3의 185개 메서드 전체를 OpenAPI 3.1로 기술하고 19개 태그로 분류했습니다. 각 메서드에는 매개변수의 타입과 필수 여부, 공식 문서 링크가 표시되며, 봇 토큰만 있으면 그 자리에서 실제로 실행해 볼 수 있습니다.

Telegram Bot API Swagger 사용 방법

  1. @BotFather에서 봇 토큰을 발급받습니다(텔레그램 봇 토큰 발급 방법 참고).
  2. Authorize를 클릭하고 토큰을 붙여넣습니다. 요청은 https://api.telegram.org/bot<token>/METHOD_NAME으로 전송되므로, 서버 영역에 token 변수가 보이면 그곳에도 토큰을 입력합니다.
  3. 원하는 카테고리 태그(예: 메시지, 업데이트)를 펼치거나 필터 입력란으로 목록을 좁힙니다.
  4. 메서드를 열고 Try it out을 클릭한 뒤 JSON 본문을 수정합니다. sendMessage라면 chat_id와 text를 채우면 됩니다. 마지막으로 Execute를 클릭합니다.
  5. 상태 코드, 응답 본문, 요청 소요 시간, 자동 생성된 curl 명령을 확인합니다.

Swagger 문서가 유용한 경우

"Try it out"은 실제 요청을 보낸다는 점에 주의해야 합니다. sendMessage는 실제로 메시지를 보내고, deleteWebhook은 실제로 웹훅을 삭제합니다. 실험은 테스트용 봇으로 하는 것이 좋습니다.

개인정보 보호

Swagger 문서는 전부 브라우저에서 동작합니다. 요청은 페이지에서 api.telegram.org로 바로 전송되므로 토큰과 API 트래픽이 저희 서버를 거치지 않습니다. 그래도 토큰이 유출되었다면 @BotFather에서 /revoke 명령으로 즉시 폐기해야 합니다.

타입별 입력 폼, Long Polling, 업데이트 기록이 필요하다면 Bot API Tester가 더 편리합니다. 메서드별 curl, Python, JavaScript 예제는 메서드 레퍼런스에서 볼 수 있습니다. Mini App을 개발 중이라면 Mini App Tester에서 Telegram.WebApp API를 테스트할 수 있습니다. 아직 봇이 없다면 텔레그램 봇 만들기 가이드부터 시작하십시오.

자주 묻는 질문

Telegram Bot API용 OpenAPI 명세가 있습니까?

Telegram은 Bot API를 core.telegram.org에서 문서로 제공합니다. 이 페이지는 Bot API 10.3의 185개 메서드 전체를 OpenAPI 3.1로 기술한 독립 명세에 Swagger UI를 얹은 것으로, Telegram의 공식 제품이 아닙니다.

Telegram Bot API Swagger에서 인증하는 방법은?

Authorize를 클릭하고 @BotFather에서 받은 토큰을 붙여넣습니다. 서버 영역에 token 변수가 보이면 그곳에도 입력합니다. 이후 요청은 브라우저에서 https://api.telegram.org/bot<token>/METHOD_NAME으로 직접 전송됩니다.

Try it out은 실제 요청을 보냅니까?

예. Execute를 누르면 입력한 토큰으로 실제 Bot API가 호출되므로 sendMessage, deleteMessage, setWebhook, logOut 같은 메서드는 실제로 적용됩니다. 실험할 때는 테스트용 봇을 사용하십시오.

이 문서는 어떤 Bot API 버전을 다룹니까?

2026년 8월 24일에 공개된 Bot API 10.3입니다. 리치 메시지와 임시 메시지를 포함한 185개 메서드 전체가 19개 태그로 정리되어 있고, 메서드마다 공식 문서 링크가 있습니다.

Swagger와 Bot API Tester 중 무엇을 써야 합니까?

레퍼런스를 훑어보고 요청 스키마를 비교하거나 curl 명령을 복사할 때는 Swagger가 편합니다. 타입별 입력 폼, 업데이트 기록이 남는 Long Polling, 빠른 토큰 확인이 필요하다면 Bot API Tester가 적합합니다.

한국어로 된 텔레그램 봇 API 문서도 있습니까?

예. 메서드 레퍼런스에서 Bot API 10.3의 185개 메서드를 한국어 설명, 매개변수 표, curl·Python·JavaScript 예제와 함께 볼 수 있으며, 각 페이지에서 공식 영어 문서로도 이동할 수 있습니다.