In deze tutorial gaan we nader bekijken hoe u kunt integreren Tilda en AppMaster. Stel dat een bepaald formulier is aangemaakt in Tilda, en onze taak is ervoor te zorgen dat de gegevens, wanneer ze worden ingevuld, naar AppMaster komen, daar worden verwerkt en in de database worden opgeslagen.
Webhook aanmaken in AppMaster
Tilda stuurt gegevens naar diensten van derden via een webhook. Daarom is het de moeite waard te beginnen met het aanmaken van de benodigde webhook en eerst het bedrijfsproces voor te bereiden op de werking ervan.
Een kenmerk van dit proces is dat vooraf niet bekend is welke gegevens precies zullen worden verkregen. De webhook werkt met "raw" verzoeken die goed verwerkt moeten worden. Hiervoor gebruiken we het Get Request Body blok. Laten we kijken welke gegevens in het algemeen van Tilda komen, deze omzetten naar String, naar het logboek schrijven en weergeven als antwoord op het verzoek.
Laten we in de sectie eindpunten meteen een nieuwe webhook aanmaken. Het is belangrijk op te merken dat het verzoektype moet zijn Raw omdat het geen hard gecodeerde invoerparameters heeft en klaar is om alle gegevens te accepteren. U moet ook uitschakelen Middleware Token Auth omdat voor het invullen van een formulier in Tilda geen autorisatie nodig is in AppMaster, en het verzenden van gegevens voor iedereen toegankelijk is.
Tilda formulier instellen
De volgende stap is het koppelen van Tilda aan de aangemaakte webhook. Om dit te doen, is het in de instellingen van de site formulieren voldoende om de URL te specificeren, hoewel u, indien nodig, extra opties kunt gebruiken. Voor extra bescherming kunt u bijvoorbeeld ook een speciale sleutel doorgeven, in de body van het verzoek of in de header.
Als alles correct is gedaan, verschijnt een bijbehorend bericht met de mogelijkheid om deze webhook onmiddellijk te koppelen aan alle formulieren op de site.
Het rest alleen nog de pagina met het formulier te publiceren en in actie te testen.
Door de logs van AppMaster te openen, kunt u zich ervan vergewissen dat de gegevens van het formulier daadwerkelijk zijn ontvangen.
Bericht: “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”
U kunt alle gegevens zien die in het formulier zijn ingevuld. Tegelijkertijd wordt duidelijk dat de gegevens in het x-www-form-urlencoded formaat, respectievelijk kunnen ze niet meer worden verwerkt als een set ruwe gegevens, maar als een verzameling afzonderlijke velden.
AppMaster databasemodel
Het rest alleen nog de juiste handler te maken. En het beste is om te beginnen met een databasemodel waarin alle informatie wordt opgeslagen.
Voor een standaardformulier is een eenvoudig model met 4 velden voldoende:
- Email (String)
- Name (String)
- Phone (String)
- Comments (Text)
Vervolgens moet u teruggaan naar het aangemaakte bedrijfsproces en het wijzigen rekening houdend met de ontvangen informatie over de samenstelling van het verzoek.
De namen van de velden uit de in te vullen tabel worden gebruikt als invoerparameters. De gegevens daaruit zullen worden gebruikt om een model (Make Tilda) te maken en vervolgens naar de database te schrijven (DB: Create Tilda).
Als laatste wordt het eerder aangemaakte eindpunt voor de webhook gewijzigd. We kennen het formaat van de binnenkomende gegevens en verwerken ze, dus de Request payload type moet Form. Tegelijkertijd moeten de in het bedrijfsproces aangemaakte parameters overeenkomen met de exacte namen van de velden van het ingevulde formulier (we zagen ze in de logs toen we de gegevens van het verzoek als ruwe gegevens ontvingen). In dit voorbeeld zijn ze bijna hetzelfde, maar verschillen ze in het geval van het eerste teken.
Nu kunt u de gemaakte toepassing publiceren en in actie testen. Als u het invullen en verzenden van het formulier herhaalt in Tilda, dan worden de gegevens verzonden naar AppMaster, weggeschreven naar de database, en dit kan worden gecontroleerd met behulp van Swagger.
