엔드포인트는 일반적으로 비즈니스 프로세스 및 애플리케이션 개발의 필수적인 부분입니다. 이 기사에서는 엔드포인트가 무엇인지, 엔드포인트가 왜 필요한지, AppMaster.io 플랫폼에서 엔드포인트를 생성하는 방법을 정의합니다.
끝점이란 무엇입니까?
끝점은 응용 프로그램의 서버 프로세스를 외부 인터페이스와 연결하는 게이트웨이입니다. 즉, 요청이 전송되는 주소입니다.
엔드포인트가 무엇인지 이해하려면 API가 어떻게 작동하는지 언급하는 것이 중요합니다. API는 응용 프로그래밍 인터페이스의 약자입니다. 애플리케이션은 API를 사용하여 타사 서비스 및 해당 사용자와 상호 작용합니다.
API에 연결하려면 요청을 보내야 합니다. 요청을 올바르게 처리하려면 클라이언트가 URL(Universal Resource Pointer), HTTP 메서드를 제공하고 메서드에 따라 헤더, 본문 및 요청 매개변수를 추가해야 합니다. 헤더는 요청에 대한 메타데이터를 제공하고 본문에는 데이터베이스의 새 행에 대한 필드와 같은 데이터가 포함됩니다.
API는 요청을 처리하고 서버에서 받은 응답을 보냅니다. 응답에는 클라이언트에게 요청 결과를 알리는 HTTP 응답 메시지의 일부인 상태 코드가 포함됩니다. 예를 들어, 작업이 성공적으로 완료된 경우 코드 200이 사용되고 내부 서버 오류가 발생한 경우 500이 사용됩니다.
끝점은 API 메서드와 함께 작동합니다. 애플리케이션이 타사 서비스 및 해당 사용자와 통신하는 데 사용하는 특정 URL입니다. URL은 다양한 요청 방법을 처리할 수 있는 경로입니다. 각 요청 유형은 별도의 엔드포인트입니다. 다섯 가지 주요 유형이 있습니다.
- GET — 서버에서 정보를 얻습니다. 요청 본문이 필요하지 않습니다.
- POST — 데이터베이스에 새 객체를 생성하고 이 객체의 필드가 있는 요청 본문이 필요합니다.
- PUT — 데이터베이스의 특정 개체를 완전히 재설정합니다.
- PATCH — PUT과 유사하게 데이터베이스의 특정 객체를 재설정하지만 요청 본문에 언급된 필드만 업데이트합니다.
- DELETE — 데이터베이스에서 개체를 삭제합니다.
특정 요청을 생성할 때 다양한 매개변수를 추가할 수 있습니다. 이러한 매개변수와 URL의 조합은 URI(Uniform Resource Identifier)를 나타냅니다. 리소스를 찾는 위치와 방법을 나타냅니다.
AppMaster.io 플랫폼에서 엔드포인트를 어떻게 구성할 수 있습니까?
AppMaster.io 플랫폼의 엔드포인트 섹션에서 자동으로 생성된 모든 엔드포인트와 프로젝트의 엔드포인트를 볼 수 있습니다. 프로젝트의 화면 및 페이지 자동 생성이 활성화된 경우 생성된 데이터 모델에 대해 해당 엔드포인트가 자동으로 생성됩니다. 또한 일부 모듈(예: 권한 부여(Auth), 국가 및 도시)을 설치할 때 끝점을 자동으로 생성할 수 있습니다.
AppMaster.io를 사용하면 여러 유형의 엔드포인트 API로 작업할 수 있습니다.
- 클라이언트 및 타사 시스템에서 백엔드에 액세스하기 위한 API
- 타사 시스템에서 알림을 수신하기 위한 웹훅
- WebSockets: 서버에 응답을 요청하지 않고 브라우저와 서버 간의 양방향 대화식 통신 세션을 열기 위한 것입니다.
모든 엔드포인트가 그룹화됩니다. 각 그룹 내에서 해당하는 모든 엔드포인트, 요청 유형, URL 및 연결된 비즈니스 프로세스를 찾을 수 있습니다. 모든 끝점은 사용자가 삭제 및 편집할 수 있습니다.
끝점을 만들거나 편집할 때 구성 창에서 다음 옵션을 사용할 수 있습니다.
- 요청 방법. GET, POST, PUT, DELETE 또는 PATCH.
- 요청 URL. 서버에 대한 경로가 있는 첫 번째 부분은 모든 애플리케이션 엔드포인트에 대해 동일하기 때문에 지정되지 않습니다. 끝을 설정하는 것으로 충분합니다(예: /users). URL 매개변수도 여기에 지정됩니다. 엔드포인트가 특정 사용자에 대한 정보를 수신하도록 설계되었다고 가정합니다. 이 경우 해당 ID는 ":"(/users/:id) 뒤에 작성하여 매개변수로 전달해야 합니다.
- 끝점 그룹. 이 매개변수는 끝점을 사용하여 작업을 구성하고 구조화하는 것을 목표로 합니다. 모든 끝점은 그룹(폴더)으로 나눌 수 있습니다.
- 비즈니스 프로세스입니다. 엔드포인트가 수행할 작업을 결정하는 가장 중요한 매개변수 중 하나입니다. 동시에 끝점 자체는 변경되지 않은 상태로 유지될 수 있습니다. 이전 주소에서 동일한 요청을 모두 수신하고 비즈니스 프로세스가 교체되면 다른 기능을 수행합니다. 기본 데이터베이스 운영을 위한 비즈니스 프로세스가 자동으로 생성됩니다. 편집할 수 없지만 필요한 경우 사용자 지정 BP로 교체할 수 있습니다.
또한 미들웨어를 설정할 수 있습니다. 미들웨어는 애플리케이션 요청을 처리할 때 필터 역할을 하는 중개 소프트웨어입니다. 미들웨어는 요청을 실행하기 전에 조건을 확인하는 데 사용됩니다. 예를 들어, 사용자 인증을 확인하기 위해 미들웨어를 생성하면 사용자가 로그인하지 않은 경우 미들웨어는 사용자를 로그인 페이지로 리디렉션합니다. 로그인되어 있으면 미들웨어가 요청 처리를 방해하지 않고 미들웨어로 전달합니다. 클라이언트.
AppMaster.io에서 엔드포인트 생성
실제로 엔드포인트의 구성을 고려하고 Aviato 프로젝트의 예시를 통해 분석해보자. 이 프로젝트를 만드는 전체 과정은 AppMaster.io 과정에서 찾을 수 있습니다.
프로젝트 내에서 두 가지 비즈니스 프로세스를 만들었습니다.
- 항공편 확인 및 생성 — 항공편 생성 비즈니스 프로세스를 대체하는 데 사용되는 프로세스입니다.
- 승객 등록 — 특정 항공편에 대한 승객을 등록하기 위한 것입니다.
이제 이러한 프로세스를 사용하여 프로젝트에서 끝점을 설정할 수 있습니다.
Validate and create Flights 비즈니스 프로세스부터 시작하겠습니다. Flight 그룹에는 이미 항공편 생성을 위한 POST/flight 엔드포인트가 있습니다. 이제 연결된 비즈니스 프로세스를 새 프로세스로 교체해야 합니다. 이렇게 하려면 끝점을 편집해야 합니다.
구성 창에서 원하는 비즈니스 프로세스를 선택합니다. 우리의 경우 이것은 Validate and create flight BP입니다. 그런 다음 필요한 모든 입력 변수를 선택하고 변경 사항을 저장해야 합니다.
이제 승객 등록 비즈니스 프로세스에 대한 다음 끝점을 설정할 수 있습니다.
우리의 목표는 특정 항공편과 관련된 승객을 볼 수 있는 섹션을 만들고 새 승객을 등록하는 프로세스를 설정하는 것입니다.
Flights 엔드포인트 그룹에서 /flights/:id/register라는 새 엔드포인트를 만들어야 합니다. 여기서 id는 비즈니스 프로세스에서 입력으로 사용할 수 있는 특정 항공편을 나타냅니다.
더하기 아이콘을 클릭하여 새 끝점을 추가할 수 있습니다. 새로운 객체를 생성하기 때문에 요청 메소드는 POST가 될 것입니다. BP에 대해 승객 등록 프로세스를 선택하고 모든 변경 사항을 저장합니다.
AppMaster.io 플랫폼에서 엔드포인트를 생성하는 것은 그만큼 쉽습니다. 전체 비디오 자습서:
결론
엔드포인트는 API 운영에 중요한 역할을 하며, 이는 차례로 프로젝트 확장과 서비스 및 애플리케이션의 편리한 통합에 필요합니다. 코드가 없는 플랫폼 AppMaster.io를 사용하면 끝점을 만들고 구성하는 작업을 쉽게 할 수 있습니다. 언제든지 플랫폼에 등록하고 모든 기능을 확인할 수 있습니다.
