API 요청 빌더
왜 API 요청 빌더를 사용해야 하나요?
REST API 테스트에는 일반적으로 Postman, Insomnia 설치나 curl 명령어 작성이 필요합니다. 저희 브라우저 기반 HTTP 클라이언트는 설치가 필요 없습니다 — 열고 바로 요청을 전송하세요.
모든 HTTP 메서드
사용자 정의 헤더와 JSON/폼 본문으로 GET, POST, PUT, PATCH, DELETE 지원
형식화된 응답
응답 본문이 들여쓰기와 함께 자동 표시, 상태 코드와 응답 시간 확인
바로 사용 가능
설치 불필요 — 계정이나 플러그인 없이 브라우저에서 완전 작동
API 요청 전송 방법
URL 및 메서드 입력
API 엔드포인트 URL을 입력하고 HTTP 메서드 선택 (GET, POST 등)
헤더 및 본문 추가
"헤더" 탭에서 Authorization, Content-Type 등 추가. POST/PUT 데이터에는 "본문" 사용.
전송 및 검사
"전송"을 클릭하여 요청 실행. 응답 본문, 상태 코드, 시간이 아래에 표시.
API 요청 빌더 사용 사례
API 디버깅
사용자 정의 헤더와 본문으로 개별 엔드포인트를 테스트하여 인증/데이터 문제 디버깅
인증 토큰 테스트
코드 작성 없이 Bearer, Basic Auth, API 키 스킴 테스트
API 탐색
공개 API(GitHub, OpenWeather, JSONPlaceholder)를 탐색하고 응답 이해
버그 재현
버그 보고서를 위한 정확한 요청/응답 데이터로 API 버그 재현 및 문서화
API 테스트 모범 사례
✓ 항상 Content-Type 설정
JSON 본문을 전송할 때는 항상 Content-Type: application/json을 포함하세요. 없으면 많은 API가 요청을 거부하거나 잘못 해석합니다.
✓ CORS 제한 이해
브라우저는 적절한 CORS 헤더 없이 크로스 오리진 요청을 차단합니다. 브라우저에서 요청이 실패하면 curl 또는 서버 사이드 프록시를 사용하세요.
✓ API 키를 하드코딩하지 마세요
프로덕션 코드에서는 환경 변수를 사용하세요. 요청 빌더는 테스트 전용입니다 — 실제 API 키가 있는 스크린샷을 공유하지 마세요.
✓ HTTP 상태 코드 확인
200=OK, 201=Created, 400=Bad Request, 401=Unauthorized, 403=Forbidden, 404=Not Found, 500=Server Error.
❓ 자주 묻는 질문
왜 크로스 오리진 요청이 실패하나요?
브라우저는 CORS(Cross-Origin Resource Sharing) 제한을 적용합니다. 대상 API에 Access-Control-Allow-Origin 헤더가 포함되어 있지 않으면 브라우저가 요청을 차단합니다. 이것은 오류가 아닙니다 — CORS 지원이 없는 API에는 curl 또는 백엔드 프록시를 사용하세요.
multipart/form-data 요청을 전송할 수 있나요?
현재 빌더는 JSON 및 일반 텍스트 본문을 지원합니다. 파일 업로드 등의 멀티파트 폼 데이터에는 Postman과 같은 전용 도구를 사용하세요.
이것이 Postman의 대안인가요?
빠른 테스트와 탐색에는 대안으로 사용할 수 있습니다. 팀 협업, 저장된 컬렉션, 환경, 자동 테스트에는 Postman이나 Bruno가 더 많은 기능을 제공합니다.
PUT과 PATCH의 차이는 무엇인가요?
PUT은 요청 본문으로 리소스 전체를 교체합니다. PATCH는 부분적인 업데이트를 적용합니다 — 본문의 필드만 변경됩니다. 대부분의 REST API는 변경되지 않은 필드를 덮어쓰지 않도록 업데이트에 PATCH를 사용합니다.