Je eerste verzoek in Make
Gebruik een HTTP-module die een request kan uitvoeren. Stel GET in naar je MANE-basisadres plus /projects?limit=10. Voeg Authorization: Bearer <servicesleutel> toe en laat de JSON-respons uitlezen. Bewaar het geheim in de beveiligde verbindingsinstellingen van je scenario.
Bekijk de ontvangen data-array. Gebruik een iterator als je de dossiers één voor één wilt verwerken. Selecteer de MANE-ID en de velden die jouw volgende stap nodig heeft. Dit is jouw veldmapping; MANE bepaalt niet automatisch welk extern veld bij een cliënt of traject hoort.
Relaties en eigen velden mappen
Kies in MANE bij Wat spreek je aan? het juiste object. Neem het endpoint en de properties-sleutels letterlijk over. Bij een object contacts kan de route /objects/contacts/records zijn; jouw eigen inrichting is leidend.
Bouw de JSON-body met een JSON-functie of JSON-module zodat aanhalingstekens en regeleinden in klantnamen veilig worden verwerkt. Gebruik properties als genest object. Een checkbox is een boolean, een bedrag een getal en een multiselect een array.
Van aanvraag naar project
Een mogelijk scenario begint met een formulier en maakt na controle een project aan. Dit is een voorbeeld dat je zelf inricht, geen standaard ingeschakelde flow.
- Gebruik de aanvraag-ID als externe referentie en controleer of je hem al hebt verwerkt.
- Zoek de juiste relatie. Vergelijk de externe referentie; beslis bewust wat je doet bij meerdere resultaten.
- Lees een actuele MANE-revisie.
- Stuur POST /projects met name en eventueel relation met de bestaande klant-ID.
- Voeg If-Match en een stabiele Idempotency-Key toe.
- Bewaar data.id en de externe aanvraag-ID samen; gebruik voortaan die mapping bij updates.
Meldingen ontvangen met een webhook
Make biedt Custom webhooks als ontvangstpunt. Gebruik het ontvangstadres bij Webhook toevoegen in MANE en kies alleen de benodigde gebeurtenissen. Ontvang eerst een fictieve wijziging om de structuur te controleren.
Controleer vóór verwerking timestamp en HMAC-handtekening over de exacte body. Als jouw Make-inrichting dit niet betrouwbaar kan doen, laat een eigen verificatie-endpoint de melding eerst controleren. Antwoord pas met succes nadat de gebeurtenis duurzaam is aangenomen.
Fouten en dubbele verwerking
Gebruik event-ID’s en je externe referentiemapping om dubbele acties te voorkomen. Een identieke timeout-herhaling gebruikt dezelfde Idempotency-Key, dezelfde body en dezelfde If-Match.
Een 409 vraagt een nieuwe leesstap en beoordeling. Een 429 vraagt wachten; een ongeldige veldwaarde vraagt correctie van je mapping. Laat een scenario niet eindeloos dezelfde ongeldige invoer herhalen. Bekijk in MANE Activiteit welke requeststatus de koppeling terugkreeg.
Een koppeling onderhouden
Maak een afzonderlijke servicesleutel per scenario of toepassing als je de toegang los wilt beheren. Noteer welke flow welk object en veld gebruikt. Controleer de mapping na een inrichtingwijziging.
Deze route gebruikt Make HTTP en webhooks. Er is geen officiële native MANE-app of automatisch geïnstalleerd Make-template in deze API-versie. Het aantal bewerkingen en de kosten van je scenario horen bij je eigen Make-inrichting.
Kom je er niet uit? Stel Jerryt je vraag.