cURL을 이용해 JSON 데이터 게시하는 방법

API 테스트를 수행할 때, 데이터 전송을 위해 JSON 데이터가 일반적으로 사용됩니다. cURL이 API 테스트를 위한 표준 명령줄 도구인 점을 감안할 때, cURL 명령을 사용하여 JSON 데이터를 어떻게 보낼 수 있을까요? 이 글은 cURL 명령을 사용하여 JSON 데이터를 POST하는 과정을 안내합니다.

💡

POST 요청은 서버로 데이터를 전송하여 처리하도록 하며, 요청 본문에 데이터가 포함됩니다. 웹 폼을 제출하거나 자원을 생성하거나 수정하는 데 일반적으로 사용됩니다. POST 요청을 더 잘 이해하고 테스트하려면 Apidog, 강력한 API 개발 도구를 사용해 봅시다.

button

cURL이란 무엇인가요?

cURL (URL의 클라이언트를 의미함)는 URL을 사용하여 데이터를 전송하기 위한 명령줄 도구 및 라이브러리입니다. HTTP, HTTPS, FTP, FTPS, SCP, SFTP, LDAP, LDAPS, DICT, TELNET, FILE 등 폭넓은 프로토콜을 지원합니다.

cURL은 HTTP 요청을 만들고, 파일을 다운로드하거나 업로드하고, 다양한 네트워크 서비스와 상호 작용하기 위해 개발 및 스크립팅 커뮤니티에서 널리 사용됩니다.

cURL을 사용하는 기본 구문은 다음과 같습니다:

bashCopy code
curl [options] [URL...]

여기 몇 가지 일반적인 옵션이 있습니다:

-X: HTTP 메서드(GET, POST, PUT, DELETE 등)를 지정합니다.
-H: 요청에 사용자 지정 헤더를 추가합니다.
-d: 요청 본문에 데이터를 전송합니다(POST 요청에 사용됨).
-o: 출력을 파일에 작성합니다.
-O: 파일을 다운로드하고 원격 파일 이름을 사용합니다.
-L: 리디렉션을 따릅니다.
-u: 인증을 위해 사용자 이름과 비밀번호를 제공합니다.

JSON이란 무엇인가요?

JSON은 JavaScript 객체 표기법을 의미하며, 경량 데이터 교환 형식입니다. 사람이 읽고 쓰기 쉽고, 기계가 구문 분석하고 생성하기 쉬운 형식입니다. JSON 데이터는 객체가 많은 프로그래밍 언어에서 표현되는 방식과 유사하게 키-값 쌍으로 표현됩니다.

JSON 데이터는 두 가지 구조로 구성됩니다:

객체: 중괄호 {}로 묶인 키-값 쌍의 무작위 모음입니다. 각 키는 문자열로, 그 뒤에 콜론과 관련 값이 옵니다.
배열: 대괄호 []로 묶인 값의 정렬된 목록입니다. 배열 내의 값은 객체와 배열을 포함하여 모든 데이터 유형일 수 있습니다.

여기 간단한 JSON 데이터의 예가 있습니다:

{
  "title": "The Catcher in the Rye",
  "author": "J.D. Salinger",
  "publishedYear": 1951,
  "isAvailable": true,
  "genres": ["Fiction", "Coming-of-age"]
}

이 예에서:

JSON 객체는 title, author, publishedYear, isAvailable와 같은 속성을 가진 책을 나타냅니다.
genres 필드는 책의 장르를 나타내는 문자열 배열입니다.

POST 요청이란 무엇인가요?

POST 요청은 서버로 데이터를 전송하여 처리하도록 사용하는 HTTP 요청 방법입니다. 데이터는 URL이 아닌 요청 본문에 포함됩니다. POST 요청은 웹 폼 제출, 서버에서 새로운 자원 생성 및 기존 데이터 수정에 일반적으로 사용됩니다.

cURL을 사용하여 JSON 데이터 POST하기

JSON 데이터를 POST하기 위해 아래 단계에 따라 제공한 예제 JSON을 사용하면 됩니다:

이 JSON 데이터를 사용하여 cURL로 POST 요청을 만드는 방법은 다음과 같습니다:

curl -X POST -H "Content-Type: application/json" -d @book.json http://example.com/api/books

명령어를 설명하겠습니다:

-X POST: HTTP 요청 방법을 POST로 지정합니다.
-H "Content-Type: application/json": 요청 본문이 JSON 형식임을 나타내기 위해 Content-Type 헤더를 설정합니다.
-d @book.json: 요청 본문에 book.json 파일의 데이터를 전송합니다.
http://example.com/api/books: POST 요청을 보내고자 하는 실제 URL로 교체하세요.

http://example.com/api/books를 POST 요청을 보내고자 하는 실제 엔드포인트로 바꾸는 것을 잊지 마세요.

파일에 데이터가 없는 경우 명령 직접에서 데이터 전송을 원하면 다음과 같이 할 수 있습니다:

curl -X POST -H "Content-Type: application/json" -d '{"title":"The Catcher in the Rye","author":"J.D. Salinger","publishedYear":1951,"isAvailable":true,"genres":["Fiction","Coming-of-age"]}' http://example.com/api/books

이 명령어는 -d 옵션을 사용하여 직접 JSON 데이터를 포함합니다. 다시 한 번, URL을 작업하는 실제 엔드포인트로 교체하세요.

Apidog으로 POST JSON 데이터를 쉽게 보내기

JSON 데이터를 손쉽게 보내는 것은 원활한 API 사용에 중요합니다. 기술에 능숙한 사용자는 cURL 명령줄을 처리할 수 있지만, 다른 사용자에게는 복잡할 수 있습니다. Apidog는 사용자 친화적인 인터페이스를 제공하여 모든 사람이 쉽게 사용할 수 있도록 도와줍니다.

Apidog의 인터페이스는 전체 프로세스를 간소화합니다. 사용자는 HTTP 방법과 데이터 형식을 쉽게 선택할 수 있습니다.

Apidog은 API 디자인에서 테스트까지 모든 것을 처리하는 완벽한 기능 세트를 자랑합니다. API와 관련된 모든 작업을 위한 원스톱 도구로, 만드는 것부터 수정하는 것까지 아우릅니다.

Apidog으로 JSON을 보내는 것은 간편합니다. POST를 선택한 뒤 Body 탭으로 가서 JSON을 선택하고 데이터를 입력하세요. Apidog은 복잡한 명령줄을 건너뛰고 사용자가 JSON을 직접 입력할 수 있도록 합니다. 기술 배경이나 cURL과 같은 도구에 대한 경험에 관계없이 API 작업에 적합합니다.

button