API 요청 보내기

설치 없이 API 확인하기

API를 개발하거나 연동할 때, 요청을 한 번 보내 보고 응답 모양을 확인하고 싶을 때가 많아요. 이 도구는 포스트맨·인섬니아 같은 프로그램의 기본 기능을 브라우저에 담았어요. 방식(GET, POST 등), 주소, 헤더, 본문을 넣고 ‘보내기’를 누르면 이 브라우저의 fetch 기능으로 요청이 바로 나가요. 홍라이프 서버를 거치지 않기 때문에 토큰이나 데이터가 중간에 저장되지 않아요.

무엇이 보내지나요

‘보낼 내용 미리보기’에 요청 줄, Host, 직접 넣은 헤더, 본문이 그대로 보여요. 본문 형식을 JSON·폼·글자로 고르면 Content-Type이 없을 때 알맞은 값을 붙여요. 여기에 브라우저가 Origin, User-Agent, Accept-Language 같은 헤더를 자동으로 더하고, ‘쿠키 함께 보내기’를 켜면 그 사이트에 저장된 쿠키도 함께 가요. 보안상 Cookie, Host, Content-Length 같은 헤더는 직접 바꿀 수 없어요.

CORS 이해하기

웹 페이지에서 다른 사이트로 보낸 요청은 그 서버가 Access-Control-Allow-Origin 헤더로 허용해야 응답을 읽을 수 있어요(CORS). 공개 API 상당수는 허용하지만, 그렇지 않은 서버는 ‘응답을 읽지 못했어요’로 나와요. 이건 서버가 고장 난 게 아니라 브라우저의 보안 규칙이라, 같은 요청을 ‘curl로 복사’해서 터미널에서 보내면 동작할 수 있어요. 또 JSON 본문이나 Authorization 헤더가 있으면 브라우저가 먼저 OPTIONS 요청(프리플라이트)을 보내요.

응답은 상태 코드와 뜻, 걸린 시간(ms), 크기, 읽을 수 있는 응답 헤더, 본문을 보여 주고 JSON이면 보기 좋게 정리해요. 본문은 원래 바이트 그대로 저장할 수 있어요. 실제 운영 토큰을 쓸 때는 화면 공유에 주의하세요.

참고한 자료

• MDN — Using the Fetch API
• MDN — Cross-Origin Resource Sharing (CORS)
• MDN — Forbidden request header