요청 재현
메서드, URL, 헤더, 본문을 한 화면에서 조합해 문제 상황을 재현하고 응답 코드를 확인합니다.
API 요청 테스트
브라우저 내부 처리
HTTP 요청을 보내고 응답을 확인한 뒤 cURL 명령으로 정리합니다.
API 요청 테스트 안전 사용
API 응답을 재현해 문서에 남기거나 버그를 신고할 때 요청을 그대로 옮겨 적을 수 있어야 합니다. 메서드, 헤더, 본문을 채워 보내고 응답과 cURL 형태를 같이 확인하면 그 절차가 짧아집니다. 다만 브라우저에서 보내는 요청이라 상대 서버가 CORS를 허용하지 않으면 응답을 읽을 수 없습니다.
cURL로 공유
브라우저에서 만든 요청을 cURL 형태로 바꿔 백엔드, QA, 운영 담당자에게 재현 명령으로 전달합니다.
CORS 영향 확인
브라우저에서 직접 요청하므로 대상 API의 CORS 설정에 따라 성공 여부가 달라질 수 있습니다.
자주 만나는 오류
CORS 오류가 날 때
브라우저에서 보내는 요청이라 대상 서버가 CORS를 허용하지 않으면 응답을 읽을 수 없습니다. 서버 문제가 아니라 브라우저 보안 정책이며, 같은 요청도 터미널의 cURL에서는 성공합니다.
민감한 값을 넣기 전에
이 도구는 입력한 주소로 실제 요청을 보냅니다. 운영 토큰이나 개인정보는 테스트용 값으로 바꾸고, 결과를 공유할 때는 헤더를 가리세요.
확인할 점
민감 값 주의
운영 토큰, 개인정보, 내부 API 주소는 테스트 전에 샘플 값으로 바꾸거나 공유 전 반드시 마스킹하세요.
브라우저 보안 정책
서버가 정상이어도 CORS, 인증 쿠키, mixed content 정책 때문에 브라우저 요청이 막힐 수 있습니다. 서버 간 요청과 결과가 다를 수 있습니다.
CORS는 서버가 정하는 것입니다
브라우저에서 다른 도메인으로 요청하면 그 서버가 허용 헤더를 보내지 않으면 응답을 읽을 수 없습니다. 이건 도구 문제가 아니라 브라우저 보안 모델입니다. 서버가 허용하지 않는 API는 터미널의 curl이나 서버 측에서 호출해야 합니다.
요청 헤더에 토큰을 넣을 때
여기 입력한 값은 브라우저를 벗어나지 않지만, 화면에 그대로 남고 브라우저 확장도 읽을 수 있습니다. 운영 환경의 액세스 토큰보다 만료가 짧은 테스트용 토큰을 쓰는 편이 안전합니다.
GET과 HEAD에는 본문이 없습니다
규격상 GET 요청에 본문을 넣을 수 있지만 대부분의 서버와 프록시가 무시하거나 거부합니다. 조건이 복잡한 조회는 쿼리 파라미터로 넣거나 POST로 바꾸는 편이 실제로 동작합니다. 응답이 비어 있으면 이것부터 확인하세요.
사용 순서와 입력 예시 더 보기
사용 순서
- 요청 메서드와 URL을 입력합니다.
- 필요한 헤더와 JSON 본문을 추가합니다.
- 요청을 보내 응답 상태, 헤더, 본문을 확인합니다.
- 공유가 필요하면 토큰과 개인정보를 마스킹한 뒤 cURL을 복사합니다.
실제 입력과 결과
요청을 cURL로 변환
입력
GET https://api.example.com/users?limit=10
Authorization: Bearer <token>결과
curl 'https://api.example.com/users?limit=10' \
-H 'Authorization: Bearer <token>'팀에 재현 방법을 공유할 때 cURL 한 줄이 가장 확실합니다.