Templates
Een body die één keer wordt geschreven en vele keren wordt verzonden.
Tools voor templates
| Tool | Wat het doet |
|---|---|
| listTemplates | Elke template op de actieve connection, met wat elke template verwacht. |
| getTemplate | Eén template op id of slug, met de gepubliceerde keys en de nieuwste versie. |
| createTemplate | Sla een body op, eventueel meteen gepubliceerd zodat hij direct kan worden verzonden. |
| previewTemplate | Render er een met meegegeven waarden, zonder te verzenden. |
| sendWithTemplate | Verzend een bericht dat uit een template is opgebouwd, met ingevulde props. |
Templates horen bij de CONNECTION, dus deze werken op de mailbox die setActiveConnection het laatst heeft genoemd, en een template die een collega heeft geschreven is er één van.
Een concept kan niet worden verzonden. previewTemplate rendert er een, sendWithTemplate weigert hem met template_not_published, en die asymmetrie is precies de bedoeling: een body die niemand heeft gepubliceerd is een body die niemand heeft goedgekeurd.
Props worden bij het verzenden streng gecontroleerd. Een onbekende key of een ontbrekende verplichte key weigert de verzending botweg in plaats van een leegte te mailen waar het ordernummer zou moeten staan, de ene fout die verderop niets zou melden.