해당 포스트는 얄팍한 코딩사전님의 REST API가 뭔가요? 강의를 듣고 작성하였습니다.

---

REST API = 정보를 주고받는 때 개발자들이 널리 쓰는 형식

UI : 사용자와 기계 간 대화를 돕는 인터페이스
API : 개발자와 기계, 기계와 기계 간 대화를 돕는 인터페이스

= 소프트웨어가 다른 소프트웨어로부터 지정된 형식으로 요청, 명령을 받을 수 있는 수단

✨ 네트워크 상에만 API가 있는 것이 아님

• Web API : 로컬 프로그램인 웹브라우저에 있는 API
• Windows API : 시스템, 하드웨어에 대한 세부 지식 없이 지정 명령어로 소프트웨어 짤 수 있는 API

그럼 REST API는?

↔ SOAP API (과거의 복잡한 API 형식)

REST API의 특징

• 한 요청의 내용을 겉보기 모습만으로 추론 가능

추론 절대 불가능한 요청들의 예시 ⬇

https://(사이트도메인)/1
https://(사이트도메인)/hello
https://(사이트도메인)/hyot-hong

겉보기 만으로도 추론이 가능한 요청들의 예시 ⬇

https://(도메인)/classes/2/students?sex=male

💡 URI : 자원을 구조와 함께 나타내는 구분자

• CRUD작업 시 서버에 REST API로 요청 보내야함 → http 규약에 따라
  REST API에서는 GET, POST, DELETE, PUT, PATCH를 사용
  → 각 요청의 의도를 쉽게 파악하도록 구분해 사용해야함

  • GET : 데이터 조회에 사용 (read)
  • POST : 새로운 정보 만들 때 사용 (create)
  • PUT / PATCH : 변경, 업데이트 될 정보 (update) (put은 정보 전체, patch는 일부)
  • DELETE : 정보 지울 때 (delete)

• URI는 동사가 아닌 명사로만 이루어져야한다

POST 하나만으로 모든 작업을 다 할 시, 깔끔하지 않음