HTTP 요청을 단계별로 작성하세요 — {userId} 같은 경로 변수, 쿼리 매개변수, 헤더, JSON/폼 본문, 인증 — 그리고 cURL, Node.js fetch, Python requests, PowerShell용 바로 실행 가능한 코드를 생성하세요. 이 도구는 설계와 생성용입니다. 요청을 실제로 보내고 응답을 살펴보려면 요청 테스트 → 버튼으로 넘기세요(REST API 클라이언트 / 테스터 열림). 붙여넣은 cURL을 되돌리려면 cURL 명령 변환기를 쓰세요. 모든 것이 브라우저에서 로컬로 조립됩니다. 이 페이지에서 어떤 요청도 결코 보내지지 않습니다.
경로 매개변수 (위 URL의 {name} 토큰)
쿼리 매개변수
헤더
본문
인증
실시간 cURL 미리보기 — 입력에 따라 갱신:
cURLNode.js fetchPython requestsPowerShell
팁: URL 조각을 중괄호로 감싸면({userId}) 경로 매개변수로 관리됩니다. 생성 코드는 매 편집마다 갱신됩니다. GET/HEAD 요청은 본문을 무시합니다. 생성되는 파일 업로드는 cURL의 @file 스타일이나 다른 언어의 플레이스홀더를 씁니다 — 실제 파일은 당신의 코드에서 붙이세요. 교차 출처 전송은 REST API 클라이언트가 다룹니다(서버의 CORS 정책 준수). 기존 명령을 되돌리려면 cURL 명령 변환기를 쓰세요.
HTTP 메서드 설명
메서드를 고르면 생성되는 cURL / Node / Python / PowerShell 코드가 맞춰 바뀝니다. 각 동사가 만들고 있는 요청에 대해 무엇을 뜻하는지:
GET — 자원의 표현을 가져옵니다. 서버 상태를 바꾸지 않아야 하며 생성된 요청에 보통 본문이 없습니다. 읽기, 검색, 목록 엔드포인트에 쓰세요.
POST — 데이터를 제출해 새 자원을 만들거나 동작을 유발합니다. 본문이 생성 코드의 페이로드가 됩니다(cURL의 --data-raw, Node/Python의 body 인자 등). POST는 멱등이 아닙니다. 두 번 보내면 자원 두 개가 만들어질 수 있습니다.
PUT — 기존 자원을 완전히 교체합니다. 본문에 전체 객체를 보내며 빠진 필드는 빈 것으로 취급될 수 있습니다. 생성 코드는 전체 본문을 정확한 URL로 보냅니다.
PATCH — 포함한 필드만 업데이트합니다. 본문이 부분 변경 집합을 실어 한두 값만 고칠 때 PUT보다 요청이 작습니다.
DELETE — URL의 자원을 제거합니다. 멱등이고 보통 본문이 없어 생성 코드는 헤더만 있는 단순 delete 호출입니다.
HEAD — 본문 없이 헤더만 요구합니다. 생성 코드는 GET처럼 보이지만 Content-Length, Last-Modified, Content-Type 같은 메타데이터를 반환해 대역폭을 아낍니다.
OPTIONS — 서버가 URL에 허용하는 것을 찾거나 CORS 사전점검을 모의합니다. 응답 헤더(예: Access-Control-Allow-Methods)가 허용된 동사를 보여줍니다. OPTIONS에는 보통 요청 본문이 없습니다.
혼동 쉬운 것:HEAD vs GET — 생성 요청은 비슷하지만 HEAD는 본문을 반환하지 않습니다. PUT vs PATCH — PUT은 자원 전체를 다시 쓰고 PATCH는 제공한 필드만 바꿉니다.