이 튜토리얼에서는 Tilda 와 AppMaster 를 통합하는 방법을 자세히 살펴보겠습니다. Tilda 에서 특정 양식이 생성되었고 우리의 임무는 데이터가 채워질 때 AppMaster 로 전달되고 그곳에서 처리되고 데이터베이스에 저장되도록 하는 것이라고 가정합니다.
AppMaster 에서 웹훅 만들기
Tilda 는 웹후크를 통해 데이터를 타사 서비스로 보냅니다. 따라서 필요한 Webhook을 생성하고 먼저 운영을 위한 비즈니스 프로세스를 준비하는 것부터 시작하는 것이 좋습니다.
이 프로세스의 특징은 어떤 정확한 데이터를 얻을지 미리 알 수 없다는 것입니다. 웹후크는 적절하게 처리되어야 하는 " raw " 요청과 함께 작동합니다. 이를 위해 Get Request Body 블록을 사용합니다. 일반적으로 Tilda 에서 어떤 데이터가 오는지 살펴보고 String 으로 변환하고 로그에 기록하고 요청에 대한 응답으로 표시합니다.
끝점 섹션에서 새 웹후크를 즉시 생성해 보겠습니다. 요청 유형은 하드 코딩된 입력 매개변수가 없고 모든 데이터를 수락할 준비가 되었기 때문에 Raw 여야 합니다. 또한 Middleware Token Auth 을 비활성화해야 합니다. Tilda 에서 양식을 작성하기 위해 AppMaster 에서 인증을 거칠 필요가 없고 데이터 전송이 모든 사람에게 열려 있기 때문입니다.
Tilda 양식 설정
다음 단계는 Tilda 를 생성된 웹훅에 연결하는 것입니다. 이렇게하려면 사이트 양식 설정에서 URL을 지정하는 것으로 충분하지만 필요한 경우 추가 옵션을 사용할 수 있습니다. 예를 들어 추가 보호를 위해 요청 본문이나 헤더에 특수 키도 전달합니다.
모든 것이 올바르게 완료되면 이 웹후크를 사이트의 모든 양식에 즉시 연결할 수 있는 기능과 함께 해당 메시지가 나타납니다.
양식이 있는 페이지를 게시하고 실제로 테스트하는 것만 남아 있습니다.
AppMaster 로그를 열어 양식의 데이터가 실제로 수신되었는지 확인할 수 있습니다.
메시지: "Email=test%40gmail.com&Name=John+Smith&Phone=%2B1-202-202-22-22&Comments=Hello%2C+world%21%0AThis+is+my+comment&tranid=6355139%3A3971256761&formid=form513738662"
양식에 채워진 모든 정보를 볼 수 있습니다. 동시에 데이터는 각각 x-www-form-urlencoded 형식으로 수신되므로 더 이상 원시 데이터 집합으로 처리할 수 없지만 개별 필드 모음으로 처리할 수 있습니다.
AppMaster 데이터베이스 모델
올바른 처리기를 만드는 것만 남아 있습니다. 그리고 모든 정보가 저장될 데이터베이스 모델로 시작하는 것이 가장 좋습니다.
표준 양식의 경우 4개의 필드가 있는 간단한 모델이면 충분합니다.
- Email (String)
- Name (String)
- Phone (String)
- Comments (Text)
다음으로 생성된 비즈니스 프로세스로 돌아가 요청 구성에 대해 받은 정보를 고려하여 변경해야 합니다.
채울 테이블의 필드 이름이 입력 매개변수로 사용됩니다. 이들의 데이터는 모델( Make Tilda )을 생성한 다음 데이터베이스( DB: Create Tilda )에 쓰는 데 사용됩니다.
마지막으로 해야 할 일은 Webhook에 대해 이전에 만든 끝점을 변경하는 것입니다. 들어오는 데이터의 형식을 알고 처리하므로 Request payload type 은 Form 이어야 합니다. 동시에 비즈니스 프로세스에서 생성된 매개변수를 완성된 양식의 정확한 필드 이름과 일치시켜야 합니다(요청에서 데이터를 원시 데이터로 수신했을 때 로그에서 확인했습니다). 이 예에서는 거의 동일하지만 첫 번째 문자의 경우가 다릅니다.
이제 생성된 애플리케이션을 게시하고 실제로 테스트할 수 있습니다. Tilda 에서 양식을 작성하고 제출하는 것을 반복하면 AppMaster 로 데이터가 전송되고 데이터베이스에 기록되며 Swagger .
