REST API
정의
- REST API는 REST 아키텍처 스타일의 디자인 원칙을 준수하는 API이다.
- RESTful API라고도 한다.
API(Application Programing Interface)란
데이터와 기능의 집합을 제공하여 컴퓨터 프로그램간 상호작용을 촉진하며, 서로 정보를 교환가능 하도록 하는 것
REST(Respresentational State Transfer)란
- www와 같은 분산 하이퍼미디어 시스템을 위한 소프트웨어의 한 형식
- 웹에 존재하는 모든 자원에 고유한 uri를 부여해 활용 하는 것
- 자원을 정의하고 자원에 대한 주소를 지정하는 방법론
특징
- 사내 시스템들도 REST 기반으로 시스템을 분산해 확장성과 재사용성을 높여 유지보수 및 운용을 편리하게 할 수 있다.
- REST는 HTTP 표준을 기반으로 구현하므로, HTTP를 지원하는 프로그램 언어로 클라이언트, 서버를 구현할 수 있다.
- REST API를 제작하면 델파이 클라이언트 뿐 아니라, 자바, C#, 웹 등을 이용해 클라이언트를 제작할 수 있다.
규칙
1. 소문자 사용
2. 언더바(_) 대신 하이픈(-) 사용
3. uri 마지막에 슬래시(/)를 포함하지 않는다.
4. 계층 관계를 나타낼 때는 슬래시 구분자를 사용(행위 포함x)
- 예) https://dev-kimchi.tistory.com/entry/java (O)
- 예) https://dev-kimchi.tistory.com/get-entry/java (X)
5. 파일 확장자를 uri에 포함하지 않는다.
- 예) https://dev-kimchi.tistory.com/entry/java (O)
- 예) https://dev-kimchi.tistory.com/entry/java.html (X)
6. 전달하고자 하는 자원의 명사를 사용하되, 컨트롤 자원을 의미하는 경우 예외적으로 동사를 허용한다.
- 예) https://dev-kimchi.tistory.com/newpost (O)
- 예) https://dev-kimchi.tistory.com/newposting (X)
7. URI에 작성되는 영어를 복수형으로 작성한다.
출처
