API, API keys, Endpoint, URL, REST API, get, post

API

두 소프트웨어 간의 통신을 지원한다. 

Application Programming Interface의 약어로, 다른 응용 프로그램에서 현재 프로그램의 기능을 사용할 수 있도록 허용하는 인터페이스를 의미합니다. API는 데이터를 검색하거나, 다른 프로그램과 상호작용하거나, 다양한 기능을 수행하는 등 다양한 방식으로 사용됩니다.

 

Endpoint는 웹 API에서 API 서비스를 실행하는 특정 경로를 의미합니다. 이 경로는 API를 통해 데이터를 요청하거나 가져오는 데 사용됩니다. 예를 들어, OpenWeatherMap API에서는 경로 /weather가 날씨 데이터를 검색하는 데 사용됩니다.

 

URL은 Uniform Resource Locator의 약어로, 인터넷에서 리소스가 위치한 위치를 식별하는 데 사용되는 문자열입니다. URL은 일반적으로 HTTP(S) 프로토콜을 사용하여 웹 페이지, 이미지, 동영상 등과 같은 리소스를 찾을 수 있습니다. API endpoint URL은 API 서비스를 실행하는 특정 경로를 나타내며, 데이터를 요청하거나 가져오는 데 사용됩니다.

 

 

REST APIs

Representational State Transfer APIs

REST API는 Representational State Transfer API의 약어로, HTTP를 기반으로한 웹 서비스 아키텍처 중 하나입니다. REST API는 HTTP 요청을 통해 자원을 조작하고, 서버의 상태를 변경하는 방식으로 동작합니다. 이러한 API는 일반적으로 GET, POST, PUT, DELETE와 같은 HTTP 메서드를 사용하여 데이터를 요청하고, 반환합니다. REST API는 웹 브라우저를 사용하지 않고 다른 애플리케이션 간에 통신할 수 있는 인터페이스를 제공합니다. REST API는 다양한 데이터 형식을 지원하며, XML, JSON 등이 자주 사용됩니다. REST API를 사용하면 HTTP 요청과 응답을 통해 다른 애플리케이션에서 자원을 공유하고, 확장성과 유연성을 제공할 수 있습니다.

 

 

API keys 

API를 사용할 때 인증 및 권한 부여를 위해 사용되는 비밀 키입니다. 이 키는 API 서비스에서 발급되며, API 요청 시 함께 전송하여 API 서비스가 인증 및 권한 부여를 수행하도록 합니다. API key를 사용하면 인증되지 않은 사용자가 API에 액세스하는 것을 방지하고, 권한이 있는 사용자만 API를 사용할 수 있도록 보호할 수 있습니다.

 

 

get과 post의 차이

HTTP(Hyper Text Transfer Protocol)에서 GET과 POST는 서버에 데이터를 요청하는 방식 중 두 가지 방법입니다.

GET은 서버로부터 정보를 조회하기 위한 방식으로, 요청하는 데이터가 HTTP Request Message의 Header 부분의 URL에 담겨서 전송됩니다. 주로 브라우저에서 링크를 클릭하거나 URL을 입력해서 웹 페이지를 요청할 때 GET 방식을 사용합니다.

반면에 POST는 서버에 정보를 제출하기 위한 방식으로, HTTP Request Message의 Body 부분에 데이터가 담겨서 전송됩니다. 주로 로그인 정보나 회원가입 정보와 같이 서버로 전송해야 할 데이터가 많은 경우나, 데이터를 전송해야 할 때 사용됩니다.


1. 요청하는 데이터의 크기
GET은 URL에 데이터를 담아서 요청하기 때문에 URL의 길이 제한(주로 2,048바이트)이 있습니다. 그러므로, 대부분의 브라우저에서 GET 요청 시 URL 길이를 제한하기 때문에 많은 양의 데이터를 전송할 수 없습니다.
POST는 HTTP Request Message의 Body에 데이터를 담아서 요청하기 때문에 데이터 크기에 대한 제한이 없습니다.

 

2. 보안
GET은 URL에 데이터를 담아서 요청하기 때문에 보안에 취약합니다. 요청하는 데이터가 URL에 노출되므로, 로그인 정보나 회원가입 정보와 같은 민감한 정보는 GET 방식으로 전송해서는 안 됩니다.
POST는 HTTP Request Message의 Body에 데이터를 담아서 요청하기 때문에 GET에 비해 보안성이 좋습니다.

 

3. 캐시(Cache)
GET 요청은 브라우저에서 캐시에 의해 저장될 수 있기 때문에, 같은 요청을 반복적으로 보낼 때 브라우저에서 캐시된 데이터를 사용할 수 있습니다.
POST 요청은 캐시를 사용하지 않습니다. 즉, 같은 요청을 반복적으로 보낼 때마다 서버에서 새로운 데이터를 가져옵니다.

 

4. 사용자의 의도
GET은 주로 조회하는 요청에 사용됩니다. 따라서 서버에 영향을 주지 않는, 즉 변경사항이 없는 요청에 적합합니다.
POST는 데이터를 생성하거나 수정하는 요청에 사용됩니다. 따라서 서버에 영향을 주는, 즉 변경사항이 있는 요청에 적합합니다.