코딩과 API를 통해 네트워크 쉽게 관리하기 - 2편

API 개요

1. API란?

• API는 애플리케이션 프로그래밍 인터페이스의 약자입니다.
• API는 소프트웨어 애플리케이션 간 통신을 가능하게 하는 프로토콜 집합입니다. 

2. API의 중요성

• API를 통해 다양한 서비스(소셜 미디어, 결제 게이트웨이, 지도 서비스 등)를 통합할 수 있습니다. 
• API는 애플리케이션 간 통신과 데이터 전송을 가능하게 합니다. 

3. API를 활용한 애플리케이션 개발

• 레스토랑 추천 앱을 예로 들면, 지도 API를 활용하여 레스토랑 위치 정보를 제공할 수 있습니다.
• 이를 통해 개발자는 핵심 기능에 집중할 수 있고, 빠르고 안정적인 서비스를 제공할 수 있습니다.

4. 네트워크 프로그래밍과 API

• 네트워크 프로그래밍에서 API는 중요한 역할을 합니다.
• API를 통해 네트워크 장비와 소프트웨어 간 통신이 가능해집니다.
• 이를 통해 네트워크 자동화, 모니터링, 관리 등이 가능해집니다.

API는 소프트웨어 애플리케이션 간 통신을 가능하게 하는 프로토콜 집합입니다. API를 활용하면 다양한 서비스를 통합하고, 핵심 기능에 집중할 수 있는 애플리케이션을 개발할 수 있습니다. 네트워크 프로그래밍에서도 API는 중요한 역할을 합니다.

반응형

REST API 개요

1. REST의 정의

• REST는 HTTP 프로토콜을 활용하여 자원(Resource)을 정의하고 해당 자원에 대한 CRUD(Create, Read, Update, Delete) 작업을 수행하는 아키텍처 스타일입니다. 
• REST는 REpresentational State Transfer를 의미하지만, REST는 HTTP 프로토콜을 사용하는 또 다른 방법에 불과합니다. REST API 서비스는 모든 요청과 응답을 TCP/TLS 연결을 통해 텍스트로 전송합니다. 아래의 예시를 확인해보시기 바랍니다.

• 프로토콜 팁: curl을 사용하여 프로토콜 응답 헤더를 보고 싶을 때, --include 또는 -i 옵션이 해당 정보를 제공합니다.

2. REST API의 특징

• 자원 중심의 설계: URI를 통해 자원을 명시합니다.
• HTTP 메서드 활용: POST, GET, PUT, DELETE 등의 HTTP 메서드를 사용하여 CRUD 작업을 수행합니다.
• 무상태성(Stateless): 각 요청은 독립적이며 이전 요청의 상태를 유지하지 않습니다.
• 캐시 가능성: HTTP 캐싱 메커니즘을 활용할 수 있습니다.
• 계층화된 시스템: 클라이언트-서버 구조를 가지며 중간 계층을 포함할 수 있습니다.
• REST는 HTTP 위에 구축된 API 프레임워크이며, 인터페이스 포인트는 종종 웹 서비스를 위한 것입니다. REST와 API를 결합하면, 애플리케이션이나 사람들이 HTTP 프로토콜을 사용하여 객체나 정보를 요청할 수 있는 간단한 서비스 인터페이스를 볼 수 있습니다.
• RESTful 디자인은 성능 요구 사항을 충족하고, 잘 확장되며, 작성하고 사용하기가 간단하고, 신뢰할 수 있기 때문에 인기를 얻고 있습니다.
• REST API 흐름은 요청과 응답을 모두 관리합니다. 애플리케이션은 GET과 같은 표준 동사를 사용하여 요청을 전송하고, 해당 요청을 이해하는 웹 서비스를 실행하는 엔드포인트로 전송합니다. 그런 다음 애플리케이션은 서비스의 엔드포인트로부터 상태 코드와 헤더가 포함된 표준 HTTP 응답을 받습니다. 응답에는 데이터 페이로드도 포함될 수 있습니다.
• 이 예시는 --verbose 옵션을 사용하는 curl GET 요청의 요청과 응답을 보여줍니다.

• HTTP 요청이나 응답 메시지의 구조를 설명할 때, 헤더와 본문(body) 사이에는 빈 줄(blank line)이 있습니다. 이 빈 줄은 헤더와 본문을 구분하는 역할을 합니다. 요청이나 응답의 본문이 시작되기 전에 이 빈 줄이 위치합니다.
• 그리고 꺾쇠 괄호(angle brackets)가 반대 방향으로 가는 경우(<)는 주로 특정 데이터나 값을 예시로 들 때 사용합니다. 예를 들어, HTML 태그나 특정 코드 조각을 설명할 때 사용할 수 있습니다. 하지만, 일반적인 HTTP 요청이나 응답 메시지의 형식에서 꺾쇠 괄호가 반대 방향으로 가는 상황은 흔하지 않습니다. 단지, 특정 값을 표현하기 위해 사용되는 경우가 있을 수 있습니다.
• 예를 들어, 앞서 언급한 요청 예시에서 "Authorization: Bearer <redacted>" 부분에서 꺾쇠 괄호는 실제 토큰 값이 들어갈 위치를 나타내기 위해 사용되었습니다. 실제 요청에서는 꺾쇠 괄호와 함께 제공된 특정 값(<redacted>) 대신, 실제 유효한 토큰 값이 사용됩니다.

3. REST API 설계 원칙

• URI는 동사보다는 명사를, 대문자보다는 소문자를 사용합니다.
• URI 마지막에 슬래시(/)를 포함하지 않습니다.
• 복수형 명사를 사용하여 자원을 표현합니다(예: /people, /books).
• HTTP 메서드를 적절히 사용하여 CRUD 작업을 수행합니다.

4. REST API 활용 사례

• 웹 서비스 API: 웹 애플리케이션 간 데이터 교환을 위해 사용됩니다.
• 모바일 앱 API: 모바일 앱과 서버 간 통신을 위해 사용됩니다.
• 마이크로서비스 아키텍처: 마이크로서비스 간 통신을 위해 사용됩니다.

REST는 HTTP 프로토콜을 활용하여 자원 중심의 API를 설계하는 아키텍처 스타일입니다. REST API는 자원 중심 설계, HTTP 메서드 활용, 무상태성, 캐시 가능성 등의 특징을 가지며, 웹 서비스, 모바일 앱, 마이크로서비스 아키텍처 등에 널리 사용됩니다.