1. 개요
Postman은 다양한 유형의 본문 매개변수를 사용하여 API 또는 서버 요청과 상호 작용할 수 있는 다양한 방법을 제공합니다 . 이는 API에 대한 HTTP 요청을 통해 데이터를 전송하는 다양한 방법을 나타냅니다.
이 사용방법(예제)에서는 요청 본문에 대해 form-data , x-www-form-urlencoded 및 raw를 사용하는 것의 차이점을 살펴보겠습니다 .
2. 양식 데이터
양식 데이터는 multipart/form-data 의 일부로 웹 사이트 양식에서 API로 전송된 데이터를 나타냅니다 . Postman의 양식 데이터 옵션은 웹 사이트에서 양식을 작성하고 제출하는 것을 시뮬레이트합니다. 양식 데이터를 편집하고 데이터에서 키-값 편집기를 변환하여 다른 키/값 쌍을 설정하도록 할 수 있습니다.
키에 파일을 첨부하는 데에도 사용할 수 있습니다. 그러나 HTML5를 사용한다는 것은 파일이 어떤 기록이나 컬렉션에도 없다는 것을 의미한다는 점에 유의해야 합니다. 따라서 요청 본문을 보낼 때 파일을 다시 선택해야 합니다. 또한 콘텐츠 유형이 포함된 여러 파일 업로드는 Postman에서 지원되지 않습니다.
Postman은 후속 사용, 즉 동일한 파일을 서버로 보내는 API 호출을 반복적으로 수행할 때 파일 경로를 유지합니다. 이는 파일 업로드 요청이 여러 개인 컬렉션을 실행하는 데 도움이 됩니다.
Postman에서 양식 데이터를 사용하는 것이 어떻게 보이는지 살펴보겠습니다 .
3. x-www-form-urlencoded
URL로 인코딩된 데이터는 인코딩된 데이터를 서버로 전송하며 URL 매개 변수와 동일한 인코딩을 사용합니다. 이를 사용하려면 요청 본문에서 x-www-form-urlencoded 탭을 선택해야 합니다 . 요청 본문을 서버로 보내려면 키-값 쌍을 입력해야 하며 Postman은 원하는 데이터를 인코딩하여 보냅니다. Postman은 키와 값을 모두 인코딩합니다.
파일을 인코딩하는 데 사용할 수 없으므로 직접 수동으로 수행해야 합니다. 그러나 요청 본문 데이터 또는 URL 매개변수만 인코딩할 수 있습니다.
이는 기본 콘텐츠 유형이라고도 합니다. 이 콘텐츠 유형으로 제출된 모든 양식은 아래 인코딩 패턴을 따릅니다.
- 컨트롤 이름과 값은 이스케이프됩니다. 모든 공백 문자는 '+' 기호로 대체되며 예약 문자는 RFC 17.38 표기법을 따릅니다.
- 등호 '='는 키와 값을 구분하는 데 사용되며 키/값 쌍은 '&'를 사용하여 서로를 구분합니다.
Postman의 x-www-form-urlencoded 탭을 살펴보겠습니다 .
4. 생
이름에서 알 수 있듯이 원시 데이터는 무엇이든 구성될 수 있습니다. Postman은 원시 문자열을 건드리거나 어떤 유형의 변경도 하지 않습니다 . 원시 편집기 에 추가된 문자열은 정의된 환경 변수를 대체하는 경우를 제외하고는 수정되지 않습니다. 이 편집기를 사용하면 원시 본문 과 함께 전송해야 하는 올바른 헤더와 함께 Postman에서 지원하는 다양한 서식 스타일을 설정할 수 있습니다 . 다음 유형이 지원됩니다.
- 텍스트
- 자바스크립트
- JSON
- HTML
- XML
이러한 콘텐츠 유형을 요청 본문에 수동으로 설정할 수도 있습니다.
5. form-data , x-www-form-urlencoded 및 raw 간의 차이점
W3C 위원회 에서 정의한 다양한 형식의 데이터 콘텐츠 유형을 사용할 수 있습니다 . 네트워크 계층을 통해 데이터를 전송하기 위한 여러 형식을 정의했습니다. 여기에는 양식 데이터 , x-www-form- urlencoded 및 원시 데이터가 포함됩니다. 기본적으로 x-www-form-urlencoded 형식을 사용하여 간단한 텍스트/ASCII 형식으로 데이터를 보낼 수 있습니다.
그러나 x-www-form-urlencoded 데이터 유형을 사용하면 데이터 제한이 있습니다. 따라서 대형 바이너리 또는 ASCII가 아닌 텍스트를 서버로 보내는 데 양식 데이터를 사용할 수 있습니다 .
원시 데이터 유형 은 이름에서 알 수 있듯이 일반 텍스트 또는 JSON을 서버로 보냅니다. 여러 콘텐츠 유형을 지원하며 Postman은 다른 데이터 유형과 달리 수정 없이 원시 데이터를 보냅니다.
원시 데이터 유형을 사용하여 요청 본문의 모든 유형의 데이터를 보낼 수 있습니다. 여기에는 서버 측에서 실행할 수 있는 Javascript 기능 전송도 포함됩니다. Javascript 옵션에서 스크립트를 보낼 수 있습니다. 원시 데이터 유형 은 HTML 및 XML과 같은 마크업 언어도 지원합니다. 이는 프런트 엔드에 논리가 없고 전체 HTML/XML 페이지를 사용해야 하는 경우에 유용할 수 있습니다.
6. 결론
이 기사에서는 Postman에서 지원하는 몇 가지 요청 본문 데이터 유형을 살펴보았습니다.
또한 Postman에서 form-data , x-www-form-urlencoded 및 raw 간의 차이점에 대해서도 설명했습니다 . 그러나 우리는 요청에 대한 기본적인 이해만 얻었습니다. 이러한 요청 본문 유형을 더 깊이 이해하려면 Postman 온라인 문서를 탐색할 수 있습니다 .
