📁 API, OpenAPI

🗒 함수

• 수학에서 함수는 어떤 값(x)를 넣으면 결과값(y)이 나온다는 것을 의미

y = ax + b
y = f(x) 

• 개발에서의 함수도 수학의 함수처럼

  만약 하얀색 공을 어떤 상자에 넣으면 노란색 공이 된다 라고 한다면,
  상자는 노란색을 입혀주는 기능이라고 할 수 있다.
  기능을 영어로 하면 function(함수)이다.

• 함수 : 어떠한 기능을 하는 것

• "프로그램을 만든다"는 것은
  = 함수를 짠다 (어떠한 기능을 만드는 것)
  = 개발을 한다
  라고 할 수 있다.

⇒ 따라서 프로그램은 기능들의 모음을 말한다.

🗒 API(Application Program Interface)

add (a, b) {
  return a + b;
}

add(a, b)는 함수일까? API일까?

• add(a, b)는 함수다!
• 하지만 API일 수도 있고, 아닐 수도 있다.

• API와 함수는 같은 건가요?
  ⇒ API도 결국은 함수의 형태를 가지고 있다. 하지만 모든 함수를 API라고 하지 않는다.

1. API

• 누군가가 쓸 수 있게 제공하는 것
• Interface라고 해서 외부에서 함수 호출(사용) 할 수 있다.
  • 외부에서 기능을 호출할 수 있게 만들었다 ⇒ API가 되는 것
  • 하지만 모든 함수를 호출할 수 있게 만든 것은 아니므로 함수는 그냥 함수다!
  • API는 API로 정의하고, API 명세서를 작성하여 외부에서 호출할 수 있게 만들어 준다.

2. OpenAPI

• 함수를 만들어서 외부에서 호출할 수 있게 하여 API를 만들었다.
  = 이 API를 누구나 쓸 수 있게 만들었다.
  = 인터넷 상에서 호출할 수 있게 만들었다.
  ⇒ OpenAPI : 특정 기능이 되게 만든 것 (예시: 지도 API, 검색 API 등)

그런데 왜 API를 노출을 할까?
원래는 자기 자신만 쓰려고 만들었는데 platform 개념이 나오면서 오픈을 하게 되었다.

OpenAPI는 무료인가요?

• 서비스 제공자의 OpenAPI를 많이 사용하면 할수록 제공자의 플랫폼을 많이 이용하게 된다.
• 무료인 경우가 많지만, 무료가 아닌 경우도 있다.
  • 데이터 사용량에 따라 비용을 지불하는 방식
• 무료인 경우에도 회원가입을 하고 신원 확인 후, 서비스 제공자로부터 인증키(공개키, 사용권한 토큰)를 발급받아 사용하여 무분별한 데이터 남용을 막기도 한다.

OpenAPI 는 어떻게 노출시키나요?

서버와 클라이언트가 있고, 클라이언트에서 서버를 호출하여 응답을 받는다.

• 호출은 어떻게 하나요?
• 브라우저에 http://www.naver.com을 적고 엔터를 치면 이것이 바로 호출!
  = 서버에 URL을 부르는 것
• 인터넷 프로토콜에 의해 도메인을 찾아 해당하는 사이트를 찾아간다.
• 응답값으로 HTML 태그들이 내려오고, 이를 브라우저가 파싱을 하여 뿌려준다.
  = 웹 사이트의 원리

⇒ OpenAPI 도 비슷한 원리로 동작한다.

위 예시의 add(a, b) 라는 함수를 OpenAPI로 만들려면?

• 인터넷 상에서 http 프로토콜에 의해 응답 받을 수 있게 노출(오픈)을 한다.
  http://www.example.com/add
• add 라는 함수를 노출 시켜 외부에서 호출 할 수 있게 되었다.
• 앱/웹에서 호출을 하면 응답값이 온다.
  http://www.example.com/add?a=1&b=2 처럼 뒤에 파라미터를 붙일 수 있다.
  그러면 기대하는 응답값으로 3이 내려온다.
• 응답값은 XML이나 json 형식
  • http://www.example.com/add?a=1&b=2 처럼 파라미터를 뒤에 붙여서 호출하는 방식을 GET 방식
  • 본문 안에 a = 1, b = 2가 들어가는 것은 POST 방식

참고 링크

• 함수, API, SDK, OpenAPI 만 알아도 개발이 보입니다. - 기술노트with 알렉
  
  • (tmi) 실은 SDK 내용 찾아보려고 본 영상인데 주로 API에 대한 설명이었고, 이해하기 쉽게 설명한 영상이었습니다. 호호
• 오픈 API - 위키백과