Servent-diensten

Waarom een dienst, en niet zelf bouwen

Een eigen wachtrij, een mailkoppeling of een pdf-generator is snel gemaakt. Het onderhoud blijft: nieuwe pogingen bij een storing, tijdzones, tokens die verlopen, geheimen die veilig moeten staan, en een proces op de achtergrond dat iemand in de gaten moet houden.

Bij Servent doet een dienst dat werk, voor alle projecten tegelijk. Je project houdt alleen zijn eigen logica: wat er moet gebeuren en wanneer. Hoe het gebeurt, regelt de dienst. CoreCRM, ons eigen product, stapt zelf ook over op deze diensten. Zo verdwijnt zijn eigen achtergrondproces.

Wat alle diensten gemeen hebben

• Eén adres. De diensten staan op api.servent.nl, elk op een eigen pad, bijvoorbeeld api.servent.nl/jobs. Alleen Pay staat nog op een eigen adres, met een eigen sleutel.
• Eén sleutel per project. Een owner of admin van je Servent-account zet een dienst aan en maakt de sleutels voor het project. Aan het token ziet de dienst welk project het is.
• Afgeschermd per project. Een project ziet alleen zijn eigen gegevens. Heeft je project zelf klanten, dan scheid je die met een scope, zoals een organisatie in CoreCRM.
• Geheimen versleuteld. Wachtwoorden en tokens die een dienst voor je bewaart, staan versleuteld opgeslagen en komen nooit terug in een antwoord.
• Ondertekende webhooks. Meldt een dienst iets aan je project, dan ondertekent hij dat volgens Standard Webhooks. Je project controleert zo dat het bericht echt van Servent komt.
• Niets dubbel. Elk verzoek kan een Idempotency-Key meekrijgen. Stuur je hetzelfde verzoek twee keer, bijvoorbeeld na een storing, dan gebeurt het maar één keer.
• Alleen naar adressen die jij opgeeft. Een dienst roept alleen adressen aan die je project vooraf heeft geregistreerd, en nooit een intern adres.

De diensten