[JavaScript] Restful API

Restful API

자원을 각 이름으로 구분해 해당 자원의 상태를 주고 받는 것.
HTTP URI를 통해 자원을 명시하고, HTTP 메서드를 통하여 상태를 주고 받는다.

메서드

메서드	설명
GET	요청받은 URI 정보를 검색한 후에 응답
POST	요청된 자원을 생성
PUT	요청된 자원을 수정
DELETE	요청된 자원을 삭제
HEAD	GET과 동일하지만, 응답 코드와 HEAD에만 반응
PATCH	PUT과 유사하지만, 일부만 수정 가능
CONNECT	동적으로 터널 모드를 교환하며 프락시 기능을 요청
TRACE	원격지 서버에 루프백 메시지 호출을 위한 테스트용
OPTIONS	웹 서버에 지원되는 메서드 종류를 확인

GET과 POST의 차이점

• GET: 지정된 리소스에서 데이터를 요청 (사용하기 위해 얻어 오는 메서드)
• POST: 리소스 생성 및 업데이트를 위하여 서버에 데이터를 전송 (리소스 생성을 위해 데이터를 저장하는 메서드)

상태 코드

	상태 코드	설명
200대	200	OK (성공) 서버가 클라이언트의 요청을 성공적으로 수행
400대 (클라이언트)	400	실패 (Bad Request) 일반적인 오류 주로 API에 필요한 필수 파라미터와 관련하여 서버가 클라이언트 오류를 감지해 요청을 처리하지 못한 상태
	401	실패 (Unauthorized) 인증 오류 (주로 토큰 관련) 해당 리소스에 유효한 인증 자격이 없어 요청에 실패한 상태
	403	권한 오류 (Forbidden) 서버에 요청이 전달되었지만 권한 때문에 거절된 상태
	429	쿼터 초과 (Too Many Request) 정해진 사용량이나 초당 요청 한도를 초과한 상태
500대 (서버)	500	시스템 오류 (Internal Server Error) 서버 에러를 총칭하는 에러 코드 요청을 처리하는 과정에서 서버가 예상하지 못한 상황인 상태
	502	시스템 오류 (Bad Gateway) 서로 다른 프로토콜을 연결해 주는 게이트웨이가 잘못된 프로토콜을 연결하거나 연결된  프로토콜에 문제가 있어 통신이 제대로 되지 않는 상태
	503	서비스 점검 중 (Service Unavailable) 서버가 요청을 처리할 준비가 되지 않은 상태
	504	시간 초과 (Gateway Timeout) 서버가 다른 서버로부터 적시에 응답을 받지 못하거나, 서버가 사용 중이거나 작동이 중지되어 제대로 작동하지 않는 상태

---

참고

- https://kakao-tam.tistory.com/17

- https://glennbouchard.com/ko/216-mengatasi-http-error-504-gateway-timeout.html