Rest API
통신을 위한 디자인 패턴
(Base URL과 Path를 조합해서 쓰는게 Rest API)
Base URL은 왜 있고
Path는 뭔지?
Base URL만 쓰는게 아니고
뒤에다 Path 덧붙임
get은 URL 만으로 테스트할 수 있음
GET은 바디가 비어있음
POST는 reqeust body가 있음
(서버에 보내줘야 하는 정보가 존재)
POST는 URL로만 접속하는건 불가능
(URL로만 접근하면 어디로 뭐를 보내줘야 하는지 모름)
→ postman.com
API 테스트하는 툴
Postman 개요 / 설치 / 사용법 / 활용 방법
프로젝트 API 문서보면
URL 접근해서
page 원하는 인트값 들어가면
파싱도 하고
연계를 해주면 됨
크롬 들어가서
json 파일 들어가면
정리되지 않은 형식으로 보임
구글 크롬 확장 프로그램
JSON이라고 검색
json viewer 설치
새로고침해서 보면
눈에 보이기 쉬운 형태로 보임 !
Q. File Array 하는 보내는 방법?
images가 배열 타입임
image를 단일로 인식하고 있어서
배열로 설정해주려면
key에서 images[]로 해주기 !
우디 & 덕복의 트러블 슈팅 👏
1. working directory 제대로 설정해두기 !
2. images [] 배열로 해주기!
([] 괄호 안에 인덱스 값 하나씩 안 넣어줘도 됨!)
서버와 어플리케이션이 통신하게 하는 프로젝트를 진행할때
서버에서 API 문서를 제공할거고
우리는 문서와 통신할 수 있는 클라이언트를 개발해야 함
이 문서를 좀 더 빠르고 쉽게 이해하기 위해 필요한 개념이 API
URL Session으로 object 값을 받아올거임 !!
API (Application Programming Interface)
기계와 기계, 소프트웨어와 소프트웨어 사이에서도
수많은 정보요청과 교환이 이루어지고 있음
이들 사이에도 소통할 수 있는 창구가 필요함
e.g. 기상청 서버로부터 앱이 실시간 정보를 받아옴
기상청 서버에게 정보들을 요청하는 지정된 형식이 있음 (날짜/ 지역, 조회할 내용 - 기온)
→ 이렇게 정보를 요청하면 이렇게 답이 올거라는 공개된 메뉴얼이 있으면 누구든 이걸 참조해서, 기상청 정보를 활용하는 소프트웨어를 만들 수 있음
REST API
REST API는 정보들이 주고받아지는 데 있어서 개발자들 사이에 널리 쓰이는 일종의 형식
(REST란 형식의 API)
어떤 기술이나 제품이 아니라 형식이기 때문에
어떤 프로그래밍 언어를 쓰든
이 폼에 맞춰서 기능을 만들어내면 되는 것
REST의 가장 중요한 특성?
각 요청이 어떤 동작이나 정보를 위한 것인지를
그 요청의 모습 자체로 추론 가능함
Restful하게 만든 API는
요청하는 주소만으로도
대략 이게 뭘 하는 요청인지 파악이 가능 !!
자원을 구조와 함께 나타내는
이런 형태의 구분자를 URL이라고 함
이런 조회 작업 뿐만 아니라
정보를 새로 넣거나
수정, 삭제하는 작업도 필요함
이를 통틀어서 C.R.U.D CRUD라고 부름
- CREATE 생성
- READ 조회
- UPDATE 수정
- DELETE 삭제
서버에 REST API로 요청을 보낼때는
HTTP란 규약에 따라 신호를 전송함
(이때 사용되는게 HTTP METHOD)
REST API에서는 주로 GET, POST, DELETE, PUT, PATCH 사용
POST, PUT, PATCH에는 BODY라는 주머니가 있어서
정보들을 GET이나 DELETE보다 많이 그리고 비교적 안전하게 감춰서 실어보낼 수 있음
누구든 각 요청의 의도를 쉽게 파악할 수 있도록
RESTful하게 API를 만들기 위해서는
HTTP METHOD들을 목적에 따라 구분해서 사용해야 함
Put vs. Patch
- Put: 정보를 통째로 갈아끼울 때
- Patch: 정보 중 일부를 특정 방식으로 변경할 때 사용
REST의 규칙 중 하나로
URL는 동사가 아닌 명사들로 이뤄져야 한다
자료 출처
REST API가 뭔가요? by 얄팍한 코딩사전
