[CS]REST API

1. REST API 정의

REST는 Representational State Transfer의 줄임말이다. REST는 클라이언트가 서버 데이터에 액세스하는데 사용할 수 있는 GET, PUT, DELETE 등의 함수 집합을 정의한다. 클라이언트와 서버는 HTTP를 사용하여 데이터를 교환한다.

2. REST API 특징

• 무상태
  (무상태는 서버가 요청 간에 클라이언트 데이터를 저장하지 않음을 의미)
• 서버에 대한 클라이언트 요청은 웹사이트를 방문하기 위해 브라우저에 입력하는 URL과 유사
• 서버의 응답은 웹 페이지의 일반적인 그래픽 렌더링이 없는 일반 데이터

3. REST API의 장점

1. 통합
   API는 새로운 애플리케이션을 기존 소프트웨어 시스템과 통합하는 데 사용된다. 그러면 각 기능을 처음부터 작성할 필요가 없기 때문에 개발 속도가 빨라진다. API를 사용하여 기존 코드를 활용할 수 있다.
2. 혁신
   새로운 앱의 등장으로 전체 산업이 바뀔 수 있다. 기업은 신속하게 대응하고 혁신적인 서비스의 신속한 배포를 지원해야 한다. 전체 코드를 다시 작성할 필요 없이 API 수준에서 변경하여 이를 수행할 수 있다.
3. 확장
   API는 기업이 다양한 플랫폼에서 고객의 요구 사항을 충족할 수 있는 고유한 기회를 제공한다. 예를 들어 지도 API를 사용하면 웹 사이트, Android, iOS 등을 통해 지도 정보를 통합할 수 있다. 어느 기업이나 무료 또는 유료 API를 사용하여 내부 데이터베이스에 유사한 액세스 권한을 부여할 수 있다.
4. 유지 관리의 용이성
   API는 두 시스템 간의 게이트웨이 역할을 한다. API가 영향을 받지 않도록 각 시스템은 내부적으로 변경해야 한다. 이렇게 하면 한 시스템의 향후 코드 변경이 다른 시스템에 영향을 미치지 않는다.

4. REST API 규칙

• 소문자를 사용
• 언더바 대신 하이픈 사용
• URI의 마지막에는 슬래시를 포함하지 않음
• 계층관계를 나타낼 때는 슬래시 구분자를 사용
• 파일 확장자는 URI에 포함시키지 않음
• 전달하고자 하는 자원의 명사를 사용하되, 컨트롤 자원을 의미하는 경우 예외적으로 동사를 허용
• URI에 작성되는 영어를 복수형으로 작성