cURL 변환기

cURL 변환기란?

cURL 변환기는 모든 API 문서, Postman 내보내기, AI 어시스턴트가 내보내는 형식인 curl 명령어를 실제 사용하는 프로그래밍 언어의 붙여넣기만 하면 되는 코드로 바꿔 줍니다. 헤더, 쿼리 문자열, JSON 바디, 멀티파트 업로드, 기본 인증, 쿠키까지 그대로 옮겨지므로 요청을 손으로 다시 작성할 필요가 없습니다.

curl은 HTTP 요청을 표현하는 가장 보편적인 방법이지만, 실제 운영 환경에서 curl을 직접 *실행*하는 경우는 드뭅니다. 보통은 JavaScript fetch, Python requests, Go의 net/http, 또는 사용 중인 스택의 도구를 씁니다. 이 도구가 그 간극을 메워 줍니다 — curl을 붙여넣고, 탭을 클릭하고, 코드를 복사하면 됩니다.

모든 처리는 브라우저 안에서 로컬로 이루어집니다. curl 명령어, 헤더, 토큰은 절대 사용자의 기기를 떠나지 않습니다 — 실제 베어러 토큰이나 세션 쿠키가 포함된 명령어를 붙여넣을 때 특히 유용하죠.

변환하면서 자연스럽게 익히게 되는 것들

• curl 플래그는 모든 HTTP 클라이언트에서 특정 개념과 짝지어집니다: -H는 요청 헤더, -d는 바디, -X는 메서드, -u는 기본 인증, -F는 멀티파트 폼 필드입니다.
• curl이 바디(-d, --data, -F)를 보는데 -X가 없으면 기본값은 POST입니다 — 대부분의 클라이언트가 쓰는 기본값과 같기 때문에, -X가 지정되지 않아도 결과 코드에서는 POST가 됩니다.
• JSON 바디와 폼 바디는 다릅니다. Content-Type: application/json은 바디가 그대로 전송된다는 뜻이고, application/x-www-form-urlencoded는 키/값 쌍이 &로 이어진다는 뜻입니다.

curl을 코드로 변환하는 방법

1. 1

   curl 명령어 붙여넣기

   복사해 온 문서에서 흔히 보이는 \ 줄바꿈 표시까지 포함해 전체 명령어를 입력창에 넣으세요. 파서가 스마트 따옴표와 PowerShell 프롬프트 표시를 자동으로 정리합니다.

2. 2

   대상 언어 고르기

   탭에는 JavaScript fetch, TypeScript, Node axios, Python requests, Python httpx, Go, PHP, Ruby, Java HttpClient, C# HttpClient, HTTPie, PowerShell이 준비돼 있습니다. 탭을 옮기는 비용은 사실상 없습니다 — 파싱은 한 번만 실행됩니다.

3. 3

   파싱된 요청 확인하기

   *Parsed request* 패널을 열어 메서드, URL, 헤더, 바디 종류, 그리고 insecure나 follow redirects 같은 옵션이 의도대로 옮겨졌는지 확인하세요.

4. 4

   복사한 뒤 인증 정보 정리하기

   생성된 코드를 프로젝트에 복사해 넣으세요. curl에 베어러 토큰이나 쿠키가 들어 있었다면, 커밋하기 전에 그 값을 환경 변수로 바꿔 두세요.

cURL 플래그 빠른 참고

이 변환기가 이해하는 플래그와 그것들이 생성된 코드에서 어떤 의미로 옮겨지는지 정리했습니다.

cURL 변환 예시

curl 'https://api.example.com/v1/lessons?limit=20&track=python' \  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.demo'

const response = await fetch('https://api.example.com/v1/lessons?limit=20&track=python', {  method: 'GET',  headers: {    'Authorization': 'Bearer eyJhbGciOiJIUzI1NiJ9.demo'  }});const data = await response.json();

curl 'https://api.example.com/v1/users' \  -H 'Content-Type: application/json' \  --data-raw '{"name":"Ada","age":36}'

import requests
headers = {    'Content-Type': 'application/json',}json_data = {"name":"Ada","age":36}
response = requests.post('https://api.example.com/v1/users', headers=headers, json=json_data)response.raise_for_status()

curl 'https://api.example.com/upload' \  -F 'caption=Hello' \  -F 'photo=@./avatar.jpg'

import requests
files = {    'caption': (None, 'Hello'),    'photo': open('./avatar.jpg', 'rb'),}
response = requests.post('https://api.example.com/upload', files=files)response.raise_for_status()

curl 'https://api.example.com/me' \  -u alice:s3cret \  -b 'session=2f9a; theme=dark'

const response = await fetch('https://api.example.com/me', {  method: 'GET',  headers: {    'Authorization': 'Basic YWxpY2U6czNjcmV0',    'Cookie': 'session=2f9a; theme=dark'  }});

curl을 변환할 때 자주 하는 실수

• 블로그에서 가져온 curl을 스마트 따옴표(', ', ", ")가 그대로 붙은 채 붙여넣는 것 — 따옴표처럼 보이지만 셸 파싱이 깨집니다. 변환기가 이를 정리해 주긴 하지만, 가능하면 원본 명령어를 그대로 복사하세요.
• 운영 환경에 -k(--insecure)를 남겨 두는 것. TLS 인증서 검증을 끄는 옵션이라 로컬 개발에서는 괜찮지만 실제 트래픽에서는 위험합니다.
• --data-raw와 --data의 동작이 다르다는 사실을 잊는 것 — --data는 입력을 URL 인코딩합니다. @나 &가 들어간 JSON 바디에는 --data-raw를 쓰세요.

cURL 변환기 자주 묻는 질문