💾 [CS] API에서의 인터페이스(Interface)란 무엇일까?

• API에서의 인터페이스(Interface)는 프로그램 간 상호작용을 위한 규칙이나 방법을 정의한 것을 의미합니다.
• 여기서 인터페이스(Interface)는 API(응용 프로그래밍 인터페이스, Application Programming Interface)가 제공하는 기능을 다른 소프트웨어나 시스템이 어떻게 이용할 수 있는지를 규정한 명세라고 할 수 있습니다.

1️⃣ API에서의 인터페이스 정의

• 인터페이스는 시스템이 제공하는 기능을 외부에서 어떻게 사용할 수 있는지에 대한 규칙과 구조를 설명합니다.
  • 이는 함수, 메소드, 데이터 형식, 호출 방법 등 다양한 요소로 구성될 수 있으며, API를 통해 소프트웨어 컴포넌트 간의 상호작용을 가능하게 합니다.

1️⃣ 주요 특징.

1️⃣ 함수나 메소드 호출 규칙.

• API는 외부 프로그램이 호출할 수 있는 함수나 메소드를 정의합니다.
  • 인터페이스는 이 함수나 메소드가 어떻게 호출되고, 어떤 인수가 필요한지, 그리고 반환 값이 무엇인지를 명시합니다.
    • 예를 들어, 특정 API에서 데이터를 가져오는 함수가 있다면, 그 함수가 어떤 입력 값을 필요로 하고, 어떤 형식의 데이터를 반환하는지 정의 된 것이 인터페이스 입니다.

2️⃣ 명세화된 입력과 출력.

• API 인터페이스는 데이터 형식과 구조를 명확히 정의합니다.
  • 이는 개발자가 API와 상호작용할 때 어떤 형식의 입력과 출력을 처리해야 하는지 이해하는 데 필수적입니다.
    • 예를 들어, API의 한 함수가 JSON 형식의 입력 데이터를 받고 XML 형식으로 출력을 반환한다면, 이 모든 사항은 인터페이스에 명시되어 있어야 합니다.

3️⃣ 추상화.

• 인터페이스는 API의 내부 구현을 추상화하고, 외부 사용자에게는 필요한 기능만을 제공하는 구조입니다.
  • API를 사용하는 개발자는 그 내부가 어떻게 동작하는지 알 필요가 없으며, 정해진 규격대로 호출하면 원하는 결과를 얻을 수 있습니다.

🙋‍♂️ DIP의 정의에서 말하는 ‘추상화된 것’과 ‘추상화’의 개념의 차이점.
🙋‍♂️ DIP의 정의에서 말하는 ‘추상화된 것’이란 무엇일까?

4️⃣ 계약(Contract)

• API에서의 인터페이스는 일종의 계약으로 간주될 수 있습니다.
  • API는 사용자에게 특정 기능을 제공하기 위한 약속을 하며, 사용자는 그 약속된 대로 인터페이스를 사용합니다.
    • 이를 통해 서로 다른 시스템 간의 원활한 통신이 가능해집니다.

2️⃣ API에서의 인터페이스의 역할.

1️⃣ 서비스 제공.

• API는 시스템이 제공하는 기능을 외부에 공개하여, 다른 시스템이나 프로그램이 그 기능을 활용할 수 있게 합니다.
  • 이 과정에서 인터페이스는 어떤 기능이 제공되는지, 어떻게 사용해야 하는지를 설명하는 설계도 역할을 합니다.

2️⃣ 호환성 보장.

• API 인터페이스는 시스템 간의 상호작용에서 호환성을 보장하는 역할을 합니다.
  • 한 시스템이 제공하는 API를 외부 시스템이 이용할 때, 인터페이스를 준수함으로써 서로 다른 시스템 간에도 일관된 상호작용이 가능해집니다.

3️⃣ 사용자와 시스템 간의 경계 설정.

• API 인터페이스는 외부 사용자가 접근할 수 있는 기능과, 내부 시스템에서만 사용되는 기능을 구분하는 경계선 역할을 합니다.
  • 이는 보안 측면에서도 중요하며, 사용자는 인터페이스를 통해 제공된 기능만을 사용할 수 있습니다.

4️⃣ 재사용성.

• 인터페이스는 동일한 규격을 따르므로, 한 번 정의된 API는 다양한 프로그램이나 시스템에서 재사용될 수 있습니다.
  • 이를 통해 개발 시간과 비용을 절감할 수 있습니다.

3️⃣ 예시: RESTful API의 인터페이스.

• RESTful API를 예로 들면, 인터페이스는 주로 HTTP 메소드(GET, POST, PUT, DELETE 등)를 사용하여 리소스에 접근하는 방법을 규정합니다.
  • GET 요청 : 특정 데이터를 가져오기 위한 규칙을 정의
  • POST 요청 : 데이터를 생성하는 방법.
  • PUT 요청 : 데이터를 업데이트하는 방법.
  • DELETE 요청 : 데이터를 삭제하는 방법.
• RESTful API의 인터페이스는 요청에 따라 어떤 경로(URL)를 사용할지, 어떤 매개변수와 헤더가 필요한지, 그리고 응답이 어떤 형태로 돌아올지를 규정합니다.

4️⃣ 인터페이스와 프로토콜의 차이점.

• 인터페이스
  • 기능을 제공하는 방식과 규칙을 설명합니다.
    • 어떨게 데이터를 입력하고, 결과를 출력받는지에 대한 약속입니다.
• 프로토콜
  • 데이터가 어떻게 전송되는지에 대한 규칙을 설명합니다.
    • 통신 규칙을 다루며, 전송 방식에 중점을 둡니다.
      • 예를 들어, HTTP나 TCP/IP는 프로토콜입니다.

5️⃣ 결론.

• API에서 인터페이스는 프로그램 간 상호작용을 위한 명세로, 외부 시스템이나 소프트웨어가 어떻게 기능을 호출하고 사용할 수 있는지를 규정합니다.
  • 이는 소프트웨어 구성 요소 간의 계약처럼 동작하며, 사용자와 시스템 간의 경계를 설정하고 호환성을 보장하여 원활한 통신을 가능하게 합니다.