REST API 입문: 요청과 응답 이해하기

대부분의 웹 API는 REST 방식입니다. 핵심 개념만 알면 어떤 API든 비슷하게 다룰 수 있습니다.

HTTP 메서드

GET은 조회, POST는 생성/전송, PUT/PATCH는 수정, DELETE는 삭제에 씁니다. 데이터 조회는 대부분 GET입니다.

인증(Authentication)

API마다 인증 방식이 다릅니다. API 키(요청에 키를 붙임), OAuth(토큰 발급 후 사용), 또는 인증이 필요 없는 공개 API도 있습니다. 이 사이트에서는 각 API의 인증 방식을 표시합니다.

요청 헤더와 파라미터

인증 토큰은 보통 Authorization 헤더나 x-api-key 헤더에 넣습니다. 검색어·페이지 같은 값은 쿼리 파라미터(?q=...&page=1)로 붙입니다.

응답과 상태 코드

응답은 대개 JSON입니다. 상태 코드로 결과를 알 수 있어요: 200(성공), 400(요청 오류), 401/403(인증 문제), 404(없음), 429(호출 한도 초과), 5xx(서버 오류).

원하는 기능의 API를 검색하면 인증 방식·문서 링크를 함께 확인할 수 있습니다.