단기집중과정 101
10 모듈
5 주

일반 정보

복사하려면 클릭

엔드포인트 소개


마지막 모듈은 첫 번째 비즈니스 프로세스의 생성으로 종료되었습니다. 프로세스 로직을 생성하고, 특정 입력 매개변수를 수락하고, 계산을 수행하고, 답변을 발행하는 방법을 알아냈습니다. 주요 질문에 대한 답변이 남아 있습니다. 생성된 비즈니스 프로세스를 활성화하고 실행하는 방법은 무엇입니까?

이 문제를 해결하기 위해 애플리케이션과 상호 작용하는 핵심 포인트인 엔드포인트가 필요합니다. 첫 번째 모듈에서 우리는 이미 외부 API와 상호 작용했습니다. 이는 엔드포인트가 있었기에 가능했습니다. 그것들은 문서에 설명되어 있고 우리는 그것을 읽고 특정 리소스에 대한 액세스 요청을 보내는 데 필요한 방법과 URL을 이해했습니다.

이해를 돕기 위해 특정 예를 사용하여 엔드포인트 구현을 살펴보겠습니다. 세 번째 모듈에서는 데이터베이스 모델이 생성되었습니다. 동시에 테이블 생성과 동시에 엔드포인트가 자동으로 생성되어 테이블과 상호 작용합니다. 끝점 섹션(왼쪽 패널에 있음)으로 이동하여 살펴보겠습니다.


도시에 대한 정보가 있는 " city " 테이블의 예에서는 기본 데이터 작업을 위한 6개의 엔드포인트가 이미 있음을 알 수 있습니다.

  • GET /city - 테이블에서 모든 데이터 가져오기
  • GET /city/:id - 지정된 ID를 가진 도시에 대한 데이터 가져오기
  • POST /city - 테이블에 새 레코드 추가
  • PUT /city/:id - 테이블에서 지정된 ID로 레코드를 완전히 교체합니다.
  • PATCH /city/:id - 테이블에서 지정된 ID로 레코드의 부분 대체
  • DELETE /city/:id - 테이블에서 지정된 ID를 가진 레코드 삭제

일반 설정

각 끝점에 대한 설정을 열고 더 자세히 연구할 수 있습니다. 예를 들어 엔드포인트 GET /city/:id 를 고려하십시오.


우리가 보는 그림은 외부 API에 대한 요청을 생성할 때 이미 본 것과 매우 유사합니다. 한 경우에는 기성 엔드포인트에만 액세스했으며 이제 이 엔드포인트를 직접 만들고 구성하고 있습니다. 구성하려면 다음을 지정해야 합니다.

  1. 요청 방법 . 이 예에서 이것은 GET 메소드입니다.
  2. 요청 URL . 서버 경로가 있는 첫 번째 부분이 지정되지 않았습니다. 모든 애플리케이션 엔드포인트에 대해 동일합니다. 끝( /city )만 지정하면 됩니다. URL 매개변수도 여기에 지정됩니다. 끝점은 특정 도시에 대한 정보를 수신하도록 설계되었으므로 ":" 뒤에 기록된 ID가 매개변수로 전달됩니다.
  3. Endpoint Groups . 이 매개변수는 어떤 식으로든 엔드포인트의 작동에 영향을 미치지 않으며 조직의 편의를 위한 것입니다. 모든 끝점은 주제 그룹(폴더)으로 나눌 수 있습니다. 이 예에서 " city " 그룹은 도시에 대한 데이터 작업을 위한 모든 끝점을 포함합니다.
  4. Business Process . 이것은 가장 중요한 구성 항목이며 끝점에 요청을 보낼 때 어떤 식 으로든 볼 수 없는 것입니다. 비즈니스 프로세스의 표시는 이 끝점이 수행할 작업을 결정합니다. 동시에 엔드포인트 자체는 변경되지 않은 상태로 유지될 수 있으며 이전 주소에서 동일한 요청을 모두 수신하며 동시에 비즈니스 프로세스가 교체되면 완전히 다른 기능을 수행합니다. 기본 데이터베이스 활동을 위한 비즈니스 프로세스가 자동으로 생성됩니다. 시스템 비즈니스 프로세스라고 합니다. 이러한 BP는 변경할 수 없지만 맞춤형 비즈니스 프로세스를 통해 독립적으로 생성된 BP로 언제든지 교체할 수 있습니다.
  5. Input/Output variables . 생성된 비즈니스 프로세스는 다양한 입력 및 출력 변수를 사용하지만 엔드포인트가 모두 사용할 필요는 없습니다. 다른 끝점이 개별 변수 집합을 사용하여 동일한 BP에 액세스하도록 부품을 비활성화하거나 구성할 수 있습니다. 요청 및 응답 유형( Request / Response type )도 여기에 구성됩니다. 대부분의 경우 이 유형은 JSON이지만 필요한 경우 XML 또는 Render File (이 유형의 응답은 파일 작업을 위한 끝점에서 사용됨)과 같은 다른 옵션을 사용할 수 있습니다.

미들웨어 설정

일반 설정은 끝점을 만들고 추가로 사용하기에 충분하지만 필요한 경우 추가 매개변수를 사용할 수 있습니다. 이 중 가장 중요한 것은 Auth 토큰으로 Middleware 를 활성화하는 것입니다.


이를 사용하면 권한이 부여되지 않았거나 특정 그룹에 속하지 않은 사용자에 대한 이 끝점에 대한 액세스를 거부할 수 있습니다(예: 액세스는 관리자에게만 부여되고 다른 사용자에게는 거부될 수 있음).

로깅 및 출력 설정

또한 Settings 탭의 설정을 사용하여 헤더 또는 요청 본문을 추가로 기록하고 값이 설정되지 않은 필드를 응답에서 숨길 수 있습니다.


Was this article helpful?
아직도 답을 찾고 계십니까?