cURL 코드 변환기

주요 사용 사례

• API 통합: 문서의 cURL 예제를 원하는 언어로 변환.
• 디버깅: 브라우저 DevTools에서 복사한 cURL을 코드로 변환하여 테스트.
• 팀 협업: cURL에 익숙하지 않은 팀원에게 요청 내용 설명.
• 빠른 개발: 보일러플레이트 없이 HTTP 요청 빠르게 구현.

예시: JSON POST 요청

curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer TOKEN" \
  -d '{"name": "Alice", "email": "alice@example.com"}'

Python 출력:

import requests

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer TOKEN",
}

data = "{\"name\": \"Alice\", \"email\": \"alice@example.com\"}"

response = requests.post(
    "https://api.example.com/users",
    headers=headers,
    data=data,
    allow_redirects=False,
)
print(response.text)

Go 출력:

package main

import (
	"fmt"
	"io"
	"log"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader("{\"name\": \"Alice\", \"email\": \"alice@example.com\"}")
	req, err := http.NewRequest("POST", "https://api.example.com/users", body)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "Bearer TOKEN")

	client := &http.Client{
		CheckRedirect: func(req *http.Request, via []*http.Request) error {
			return http.ErrUseLastResponse
		},
	}
	resp, err := client.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer resp.Body.Close()

	respBody, err := io.ReadAll(resp.Body)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(string(respBody))
}

본문은 입력한 문자열 그대로라서 서버가 받는 바이트는 curl과 같습니다. allow_redirects=False와 http.ErrUseLastResponse가 있는 이유는 curl이 -L 없이는 리다이렉트를 따라가지 않지만 requests와 Go의 http.Client는 기본으로 따라가기 때문입니다. Go 코드는 오류를 버리지 않고 모든 오류에서 log.Fatal로 멈춥니다.

코드 검증 방법

도구의 테스트는 각 예시 명령을 로컬 HTTP 서버로 두 번 보냅니다. 한 번은 실제 curl, 한 번은 생성한 Python, Go, JavaScript 코드입니다. 서버는 메서드, 경로와 쿼리, 헤더, 본문을 비교합니다. multipart 본문은 경계 문자열이 무작위라서 파트별로 비교합니다. Node.js 출력은 node --check로 ES 모듈인지 확인합니다. 예시는 여러 개의 -d, -G, --json, --data-urlencode, -F 파일 업로드, -d @file, Basic 인증, HEAD, -L 유무에 따른 리다이렉트, Chrome이 쓰는 $'...' 따옴표를 포함합니다.

옵션 변환 방식

규칙은 curl 매뉴얼을 따릅니다:

옵션은 묶어 쓰거나(-sSL) 값을 붙여 쓸 수 있습니다(-XPUT, -H'X: 1'). curl 8.7에 없는 옵션은 오류가 나며 URL로 읽히지 않습니다.

실행 전에 확인할 것

• **JavaScript(fetch)**는 페이지 안에서 실행되므로 로컬 경로를 열 수 없습니다. 업로드할 파일과 @file 본문은 <input type="file">에서 가져오며, 주석에 적힌 순서대로 고릅니다. fetch는 리다이렉트도 따라가고, Cookie, Host 같은 금지된 요청 헤더는 브라우저가 뺍니다.
• JavaScript 탭의 name=<file 텍스트는 CRLF 줄바꿈으로 전송됩니다. FormData가 HTML 폼 인코딩 규칙에 따라 텍스트 값의 줄바꿈을 맞추기 때문입니다. Python, Go, PHP, Node.js는 파일 내용을 그대로 보냅니다.
• Node.js는 axios를 쓰며 4xx, 5xx 응답에서 예외를 던집니다(curl은 던지지 않음). maxRedirects: 0은 -L 없는 curl에 맞춘 것이라 3xx 응답에서도 예외가 납니다. 파일 업로드는 fs.openAsBlob을 쓰므로 Node.js 19.8 이상이 필요합니다.
• PHP에서는 같은 이름의 -F 필드가 하나만 전송됩니다. PHP 배열은 키마다 값을 하나만 가지기 때문입니다.
• $VAR, $(...), 파이프 같은 셸 문법은 펼치지 않습니다. "$TOKEN"은 글자 그대로 $TOKEN이 됩니다.

브라우저에서 요청 복사하기

Chrome이나 Edge 개발자 도구의 Network 패널에서 요청을 오른쪽 클릭하고 **Copy → Copy as cURL (bash)**를 고릅니다. 값에 따옴표나 줄바꿈이 있으면 이 형식은 $'...' 따옴표를 쓰며, 변환기는 이를 읽습니다. Windows에서도 bash 버전을 고르세요. cmd 버전은 ^로 이스케이프하며 이 변환기는 읽지 않습니다. 이렇게 복사한 요청에는 쿠키와 토큰이 들어 있는 경우가 많지만, 이 페이지는 분석 도구와 광고를 불러오지 않으며 변환은 브라우저에서 이루어집니다.