[ 개발 원리 ] API 가 무엇인가? & 마이그레이션

해당 업체의 API를 써서 값을 가지고 와야 하고, 기존 데이터는 마이그레이션해야 합니다.

 

📌 API

Application Programming Interface 의 약자.

1. 프로그램들이 서로 통신하거나 상호작용 할 수 있도록 도와주는 매개체이자 약속이다.

2. 응용프로그램에서 사용할 수 있도록 운영체제, 프로그래밍 언어가 제공하는 기능을 제어할 수 있게 만든 인터페이스

ex ) 데이터를 주고 받는다든지, 호출한다든지, 기능을 원할히 사용하도록 인터페이스를 제공하는 것.

Open API ( Open Application Programming Interface )

누구나 사용할 수 있도록 공개된 API

 

쉽게 설명해줘

API

식당의 메뉴판

고객과 주방을 이어주는 역할을 하는 것이 메뉴판이며, 고객은 메뉴판 사용법만 잘 익혀서 사용하면 된다.

 

만약 숙박업체의 예약관리 프로그램을 만든다면?

1. 숙박 업체로부터 데이터를 취합, 데이터베이스 구축.

2. 외부에 서비스할 때 (1) 직접적인 데이터 전달 & (2) DB 직접 접근 & (3) API 방식으로 이용 등을 통해서 처리.

https://reinvite.tistory.com/109

---

🤍 프로그램에서 API를 정의하면 뭐가 좋은가?

∎ client 프로그램은 소통할 프로그램이 어떤 프로그램인지, 구현이 어떻게 되어있는지 신경쓰지 않고 약속된 API만 사용하면 소통이 가능하다.

API를 사용할 경우, 이미 약속된 내용이기 때문에 상대방이 누구든 상관없이 API만 호출하면 원하는 결과를 얻을 수 있다.

 

∎ 공통된 로직을 효율적으로 관리할 수 있다.

하나의 프로그램과 소통하는 여러 client 프로그램이 있을 경우 각각의 client에서 똑같은 로직을 들고 있는 것보단 하나의 프로그램에서 공통된 로직을 제공해주는 것이 효율적, 유지보수적으로 편리하다.

 

∎ 유지 보수 및 확장 용이

HTTP 와 같은 범용 프로토콜을 사용하는 API의 경우 웹, 안드로이드, IOS 환경에서 동일한 API를 사용할 수 있어서 서로 다른 환경에서 동일한 기능 구현이 간편.

 

Note!
HTTP 프로토콜이란?
HTTP ( Hypertext Transfer Protocol ) 는 통신 프로토콜이다.

프로토콜	상호 간에 정의한 규칙을 의미. 특정 기기 간에 데이터를 주고받기 위해 정의.

웹에서는 브라우저와 서버 간에 데이터를 주고받기 위한 방식으로 HTTP 프로토콜을 사용하고 있다.

 

만약 API에 버그가 있거나 개선해야 한다면?

API를 제공하는 프로그램만 수정하면 된다.

---

🤍 웹 API 의 종류

웹 API

인터넷을 통해 병합된 컴퓨터들 간의 통신시 사용하는 API. 어플이나 웹사이트에서 사용한다.

웹 API의 경우 API를 정의했던 시기와 이유에 따라 다음과 같은 종류로 나뉘어진다.

SOAP API	단순 객체 프로토콜을 사용한다. 클라이언트와 서버는 XML을 사용하여 메시지를 교환. 유연성이 떨어지는 API ( 과거에 많이 사용 )
RPC API	원격 프로시저 호출. 클라이언트가 서버에서 함수나 프로시저를 완료하면 서버가 출력을 클라이언트로 다시 전송.
Websocket API	JSON 객체를 사용하여 데이터를 전달. 클라이언트 앱과 서버 간의 양방향 통신을 지원. REST API보다 효율적이다. -> 서버가 연결된 클라이언트에 콜백 메시지를 전송할 수 있기 때문.
REST API	웹에서 가장 많이 사용되는 API. 클라이언트가 서버에 요청을 데이터로 전송. 서버가 클라이언트 입력을 사용하여 내부 함수를 시작하고 출력 데이터를 다시 클라이언트에 반환.

---

🤍 API  장점

1. API 표준화

API는 상호작용시 특정 기기나 OS에 종속되도록 구현하지 않으므로, 기기나 OS에 상관없이 다양한 프로그래밍 언어로 접근하여 사용한다.

 

2. API를 이용한 애플리케이션 개발 및 여러 서비스 기획안 창출

API를 이용하면 공공 데이터 및 오픈 데이터를 활용하여 고객이 원하는 정보만을 폼 디자인하여 서비스할 수 있다. 그리고 여러 비즈니스 기획을 할 수 있다.

---

📌 마이그레이션 ( Migration )

∎ 한 운영환경에서 다른 운영환경으로 옮겨가는 과정.

    한 종류의 데이터베이스에서 다른 종류의 데이터베이스로 옮기는 경우도 포함된다.

 

마이그레이션은 보통 DB마이그레이션을 말하기도 한다.

특정 프로젝트로 인해서 DB스키마가 변경되었을 때 기존 기능을 유지하기 위해 마이그레이션을 한다.

Note!

DB 스키마 ( DB schema )

데이터베이스에서 자료의 구조, 자료의 표현방법, 자료 간의 관계를 형식 언어로 정의한 구조.

 

ex ) 설명 예시

특정 프로젝트로 인해 A 기능 사용 시 저장되는 DB값 변경.

- ( 변경 전 ) A기능 사용 시 DB에 1로 저장됨.

- ( 변경 후 ) A 기능 사용 시 DB에 A로 저장됨.

 

DB에서 1 -> A로 바꾸는 작업을 해야한다.

이러한 경우를 DB 마이그레이션 작업이라고 한다.

---

- API 에 대한 설명

https://careerly.co.kr/

이양일 / API 가 뭔가요 | 커리어리

https://www.inflearn.com/

공공 데이터 (오픈 데이터) API 제대로 배우기 Part.1 - 인프런 | 강의

- HTTP 프로토콜 설명

https://joshua1988.github.io/

프런트엔드 개발자가 알아야하는 HTTP 프로토콜 Part 1

- API & 마이그레이션 설명

https://reinvite.tistory.com/

알아두면 좋은 개발용어 8 (API, 마이그레이션)