예시
옵션
URL: https://api.yutils.dev/tools
method: POST
headers: Content-Type: application/json
body: { "name": "new-tool" }출력 (curl 명령)
curl -X POST 'https://api.yutils.dev/tools' \
-H 'Content-Type: application/json' \
-d '{ "name": "new-tool" }'참고
JSON Content-Type 자동 감지 — body 가 JSON 이면 header 추천. 셸 안전을 위해 single quote 우선.
사용법 / 자주 묻는 질문
이런 경우 사용하세요
- Postman · Insomnia 없을 때 빠른 API 호출 명령 생성
- 이슈 · 문서에 API 호출 예시 첨부
- 동료에게 "이렇게 해보세요" 공유용 curl 명령
- CI 스크립트에 박을 curl 검증
- 복잡한 API 호출의 header / body 구조 정리
자주 묻는 질문
- Q.Windows PowerShell 에서도 작동하나요?
- A.기본 출력은 bash / zsh 기준 (single quote). PowerShell 은 `curl` 이 `Invoke-WebRequest` alias 라 다르게 동작 — `curl.exe` 명시하거나 정식 PowerShell 문법으로 변환 필요.
- Q.Authorization 헤더의 secret 은 어떻게 다루나요?
- A.환경변수로 빼는 것을 권장 — `-H "Authorization: Bearer $TOKEN"`. 토큰을 직접 박은 명령을 이슈에 붙이지 마세요.
- Q.한글이 박힌 body 는?
- A.UTF-8 그대로 전달됩니다. 단, 셸에 따라 escape 가 필요할 수 있어 `--data-binary` 또는 파일로 전달이 더 안전 — `curl -d @body.json`.
재미있는 사실
curl 은 1996년 스웨덴의 Daniel Stenberg 가 만들었습니다 — 처음엔 'httpget' 이라는 이름이었다가 'urlget' 을 거쳐 'curl' 로 정착. 이후 30년간 거의 한 사람이 관리하면서 모든 운영체제·언어·디바이스의 표준 HTTP 도구로 자리잡았어요.
Wikipedia — curl'curl in everything' — curl 은 iOS·macOS·Windows·Linux 기본 탑재, 자동차 인포테인먼트, IoT, 비행기 시스템, 화성 탐사로봇 Curiosity, 우주정거장 ISS 까지 사용. 'Stenberg 의 노트북이 멈추면 인터넷이 흔들린다' 는 농담이 진담에 가깝습니다.
curl — Companies usingcurl 7.66 (2019) 부터 HTTP/3 (QUIC) 지원이 들어왔습니다 — Stenberg 본인이 IETF QUIC 워킹그룹 활성 멤버여서 사실상 모든 HTTP 표준의 reference 구현 역할도 합니다. 명세와 구현이 같은 사람 손에서 나오는 드문 케이스.
curl — HTTP/3
관련 도구
- Base64 인코딩 / 디코딩
텍스트를 Base64로 인코딩하거나 디코딩합니다. 브라우저에서 즉시 실행되며 서버로 데이터가 전송되지 않습니다.
- URL 인코딩 / 디코딩
URL에 사용할 수 있도록 텍스트를 퍼센트 인코딩하거나 인코딩된 URL을 디코딩합니다. 브라우저에서 즉시 실행됩니다.
- UUID / ULID 생성기
UUID v4(랜덤) · UUID v7(시간 순서, RFC 9562) · ULID를 브라우저에서 생성합니다.
- JWT 디코더
JWT(JSON Web Token)의 header와 payload를 디코딩하여 표시합니다. 서명 검증은 수행하지 않으며(공개키 필요), 토큰은 브라우저에서만 처리됩니다.
- JWT 생성기 (HMAC)
HS256/HS384/HS512(HMAC-SHA) 알고리즘으로 서명된 JWT를 생성합니다. payload·secret 모두 브라우저에서만 처리 — Web Crypto API 기반.
- SHA 해시
텍스트의 SHA-1·SHA-256·SHA-384·SHA-512 해시를 계산합니다. 브라우저의 Web Crypto API를 사용하며 데이터가 서버로 전송되지 않습니다.
- Hex 인코딩 / 디코딩
텍스트를 16진수로 인코딩하거나 디코딩합니다. UTF-8을 자동 처리하며 공백을 무시합니다.
- HTML 엔티티 인코딩 / 디코딩
HTML 특수 문자(&, <, >, ", ')를 엔티티로 인코딩하거나, 이름/숫자 엔티티를 텍스트로 디코딩합니다.
- 비밀번호 생성기
암호학적으로 안전한 비밀번호·토큰·랜덤 문자열·패스프레이즈를 생성하고 엔트로피를 표시합니다.
- 진수 변환기
BigInt 기반으로 큰 정수까지 2/8/10/16/36진수 변환. 0b/0o/0x 자동 감지.
- URL 파서
URL을 프로토콜·호스트·경로·쿼리·해시로 분해해 한눈에 보여줍니다 (읽기 전용).
- HMAC 생성기
Web Crypto API로 SHA-1/256/384/512 HMAC을 계산합니다. 서명·검증 키 기반.
- HMAC 검증기
주어진 HMAC 서명이 message + secret 으로 만든 값과 일치하는지 검증합니다. Web Crypto API + constant-time 비교.
- MD5 해시
텍스트의 MD5 해시를 계산합니다. 주의: MD5는 보안용으로 부적합 — 체크섬·레거시 호환에만 사용.
- Punycode (국제화 도메인)
한글·다국어 도메인을 Punycode(xn-- ASCII)로 상호 변환합니다. 브라우저 native URL 사용.
- HTTP 상태 코드
HTTP 상태 코드(1xx-5xx)를 검색·탐색합니다. 설명과 일반 사용 사례 포함.
- User-Agent 파서
User-Agent 문자열을 브라우저·OS·기기·엔진별로 분해합니다.
- Bcrypt 해시
Bcrypt로 비밀번호를 해시하거나 기존 해시와 평문을 검증합니다. salt rounds 조정 가능.
- 쿠키 파서
Cookie 또는 Set-Cookie 문자열을 표로 분해합니다. percent-encoded 값 복원 + Set-Cookie 속성(Path/Domain/Max-Age/SameSite/HttpOnly/Secure) 인식.
- IP / CIDR 계산기
IPv4 주소와 CIDR로 네트워크 주소·브로드캐스트·호스트 범위·서브넷 마스크·호스트 수를 계산합니다.