Een externe checker of vragenlijst verbinden

Een extern formulier bevat zijn vragen in een andere toepassing, zoals een calculator of quiz. Trelyn ontvangt de uitkomst en kan die aan een contact of bedrijf koppelen. Dit is een andere koppeling dan de algemene developer-API.

#Voorbereiden in Trelyn

1. Maak een formulier van het externe type aan.
2. Open de API-tab en kopieer het getoonde formulierendpoint en formulier-ID.
3. Genereer indien nodig de formsleutel en bewaar deze veilig; de volledige sleutel wordt maar eenmaal getoond.
4. Laat de ontwikkelaar het voorbeeldverzoek uit deze tab gebruiken.
5. Controleer bij Instellingen of ondertekening vereist is.
6. Sla op en publiceer vóór de integratie echte inzendingen gaat sturen.
7. Controleer een testinzending en stel daarna de mapping in.

#Sleutel en ondertekening

De ontwikkelaar gebruikt de sleutel aan de serverkant voor de getoonde verzoekondertekening. Plaats een geheime sleutel niet in openbare websitecode. Een nieuwe sleutel uitgeven maakt de vorige ongeldig; werk de bestaande integratie dus direct bij.

Als ondertekening uitstaat, kan iemand die het formulier-ID kent zelf inzendingen posten. Beoordeel de getoonde melding voordat je dat voor een browserintegratie toestaat.

#Antwoord controleren

Een niet-gepubliceerd formulier accepteert de bron niet als een live inzending. Lees de antwoordbody naast de HTTP-status: een verzoek dat genegeerd wordt hoeft geen transportfout te geven. De API-tab vermeldt de concrete antwoorden en het gebruik van een idempotentiesleutel voor veilige herhalingen.

Voor algemene API-sleutels en webhooks lees je de developerhandleidingen. Voor ontbrekende inzendingen gebruik je deze controles.