HTTP POST 메세지를 수신하고 표시해주는 파이썬 코드

 

HTTP POST 메세지란?

HTTP POST 메시지는 HTTP 프로토콜을 사용하여 클라이언트와 서버 간에 데이터를 전송하는 데 사용되는 메시지입니다. 이 메시지는 클라이언트에서 서버로 데이터를 보낼 때 사용됩니다.

POST 메시지에는 HTTP 요청 헤더와 메시지 본문이 포함됩니다. HTTP 요청 헤더는 요청의 세부 정보를 설명하며, 메시지 본문에는 전송할 데이터가 포함됩니다. 이러한 데이터는 보통 HTML 양식 데이터나 JSON, XML 등의 데이터 형식으로 이루어져 있습니다.

POST 메시지를 사용하여 서버에 데이터를 보내면 서버는 이를 처리하고 응답을 반환합니다. 이를 통해 클라이언트는 서버와 상호 작용하며 웹 애플리케이션 등에서 필요한 데이터를 전송하고 처리할 수 있습니다.

 

HTTP POST 송신 프로그램

https://www.postman.com/downloads/

Download Postman | Get Started for Free

 

Postman은 API 개발 및 테스트를 위한 인기 있는 협업 도구 중 하나입니다. Postman은 RESTful API를 테스트하고 디버그하며, API를 문서화하고 모니터링하는 기능을 제공합니다.

Postman은 사용하기 쉽고 직관적인 UI를 제공하여 사용자가 HTTP 요청을 구성하고 전송할 수 있습니다. 사용자는 헤더, 쿼리 매개변수, 요청 본문 등을 쉽게 수정하고 테스트할 수 있습니다. 또한, Postman은 API 응답을 시각적으로 보여주어 응답 결과를 쉽게 이해할 수 있도록 도와줍니다.

Postman은 다양한 기능을 제공합니다. 예를 들어, Postman은 테스트 스위트를 만들고 실행할 수 있으며, 테스트 결과를 공유하고 동료와 협업할 수 있습니다. 또한 Postman은 API 요청을 자동화하고, 스크립트를 작성하여 테스트를 자동화할 수 있는 기능도 제공합니다.

Postman은 무료로 사용할 수 있는 버전이 있으며, Pro 버전도 제공됩니다. Pro 버전은 팀 협업, API 모니터링, 팀 워크스페이스 등 고급 기능을 제공합니다.

 

RESTful API란?

RESTful API는 Representational State Transfer(표현 상태 전송) 아키텍처 스타일을 따르는 웹 API입니다. RESTful API는 웹 상의 자원(리소스)을 사용하여 클라이언트와 서버 간에 통신하며, HTTP 프로토콜을 사용합니다.

RESTful API는 자원을 고유한 URI(Uniform Resource Identifier)로 식별하고, HTTP 메서드(GET, POST, PUT, DELETE 등)를 사용하여 해당 자원에 대한 작업을 수행합니다. 이러한 URI는 일반적으로 리소스의 이름과 버전 정보를 포함합니다.

RESTful API는 자원의 상태를 표현하는 데에도 중점을 둡니다. 예를 들어, 클라이언트는 GET 요청을 사용하여 서버에서 리소스의 상태를 가져오고, PUT 요청을 사용하여 리소스의 상태를 업데이트합니다. 이를 통해 RESTful API는 클라이언트와 서버 간에 자원의 상태를 전송하고, 동기화하는 데에 용이합니다.

RESTful API는 다양한 형식의 데이터를 지원합니다. 예를 들어, JSON, XML, HTML 등의 데이터 형식을 지원합니다. 또한, RESTful API는 캐싱 기능을 지원하여 클라이언트의 요청 처리를 최적화할 수 있습니다.

RESTful API는 쉽게 이해하고 사용할 수 있으며, 확장성이 높습니다. 이러한 특징 때문에 RESTful API는 현재 가장 인기 있는 웹 API 아키텍처 중 하나입니다.

 

HTTP POST 수신을 위한 코드

POST 메세지를 수신 받는 시스템이 있을 경우 위에 소개한 POSTMAN 등의 툴을 사용하여 POST 메세지를 보낼 수 있습니다.

그러나 POST 메세지를 보내는 시스템을 만들고 테스트를 해야할 경우, 그 메세지를 확인하기 위한 툴은 쉽게 찾기가 어려웠습니다.

 

다음은 파이썬을 사용하여 POST 메세지를 수신하고 표시해주는 간단한 코드입니다.

 

파이썬을 설치한 뒤 메모장에 아래 코드를 입력하고 .py 확장자로 저장한 뒤 실행해주면 바로 실행됩니다.

 

https://www.python.org/downloads/

Download Python

 

이 서버는 Flask 웹 프레임워크를 사용하여 작성됩니다.

먼저, Flask와 request 모듈을 가져옵니다.

 

from flask import Flask, request

 

다음으로, Flask 애플리케이션을 만들고 라우트를 정의합니다. '/' 경로로 POST 요청이 수신되면, 요청된 메시지를 표시하는 함수를 호출합니다.

 

app = Flask(__name__)

@app.route('/', methods=['POST'])
def display_message():
    message = request.data.decode('utf-8')
    print(message)
    return 'Message received'

 

여기서 request.data는 요청의 본문(body)에 있는 데이터를 가져옵니다. 이 경우, 본문은 문자열 형식으로 들어올 것으로 예상하므로, decode() 함수를 사용하여 바이트 문자열을 유니코드 문자열로 디코딩합니다.

마지막으로, 서버를 실행합니다.

 

if __name__ == '__main__':
    app.run(debug=True)

위의 코드를 실행하면, http://127.0.0.1:5000/ 경로로 POST 요청을 보내면 서버 콘솔에 메시지가 출력됩니다.

 

외부 IP로부터 메시지를 수신하도록 코드를 변경하기 위해서는, Flask 애플리케이션을 app.run() 함수에 인자로 외부 IP와 포트 번호를 지정해주어야 합니다.

 

if __name__ == '__main__':
    app.run(debug=True, host='0.0.0.0', port=8000)

 

전체 코드는 아래와 같습니다.

 

from flask import Flask, request

app = Flask(__name__)

@app.route('/', methods=['POST'])
def display_message():
    message = request.data.decode('utf-8')
    print(message)
    return 'Message received'

if __name__ == '__main__':
    app.run(debug=True, host='0.0.0.0', port=8000)

 

위의 코드를 실행하면, http://[서버의 외부 IP 주소]:8000 경로로 POST 요청을 보내면 서버 콘솔에 메시지가 출력됩니다. 단, 이 코드는 외부 IP 주소에 대한 방화벽 설정 등의 문제가 없어야 정상적으로 동작합니다.

 

포트를 변경하고 싶을 경우 'port=8000' 의 값을 변경해주면 됩니다.

 

오류 확인

파이썬을 처음 설치해서 바로 실행한 경우 다음과 같이 flask 모듈이 없다는 오류가 표시됩니다.

flask 모듈 없음

 

이 경우, CMD 창에서 'pip install flask' 라고 입력해주면 자동으로 flask 모듈을 설치하게 됩니다.

pip install flask

 

이제 실행을 해보면 정상 실행이 됩니다.

정상 실행

 

실행 확인

위에 소개한 POSTMAN으로 POST 메세지를 보냅니다.

저는 동일한 PC에서 진행하였으므로 루프백 IP인 127.0.0.1 로 보냈지만 다른 PC에서도 IP를 지정하여 정상 동작됩니다 (방화벽 확인 필요)

POSTMAN으로 POST 메세지를 보내보자

 

메세지 정상 수신 확인