Archiveren via API en webhooks (koppeling met uw CMS)
Laat uw CMS bij elke publicatie automatisch een opname starten. Met ons trigger-endpoint en HMAC-ondertekende webhook-callbacks koppelt u websitearchivering rechtstreeks aan uw publicatieproces — zonder dat iemand er handmatig naar hoeft om te kijken.
Een opname starten met het trigger-endpoint
Uw systeem start een opname met een eenvoudige aanroep: POST /api/triggers/<id>. De aanroep wordt geauthenticeerd met een Bearer-token en is voorzien van rate limiting, zodat een drukke publicatiestroom uw koppeling niet kan overbelasten. Met een idempotency-key voorkomt u dat een per ongeluk herhaalde aanroep tot dubbele opnamen leidt: dezelfde sleutel levert één opname op.
Wilt u de site niet midden op een werkdag belasten? Geef dan de optie 'defer to night' mee. De opname wordt dan in de daluren ingepland in plaats van direct uitgevoerd, terwijl uw CMS gewoon een nette bevestiging terugkrijgt.
Resultaat terug via webhooks
U hoeft niet te wachten of te pollen. Zodra er iets gebeurt, sturen wij een uitgaande webhook naar uw eigen endpoint. De relevante gebeurtenissen zijn:
- crawl.deferred — de opname is doorgeschoven naar de daluren;
- crawl.completed — de opname is geslaagd, inclusief omvang in MB en het aantal pagina's;
- crawl.failed — de opname is mislukt, met de reden.
Elke callback is ondertekend met HMAC-SHA256. Door de handtekening met uw gedeelde geheim te controleren weet uw systeem zeker dat het bericht echt van ons komt en onderweg niet is gewijzigd.
Automatisch archiveren bij publicatie
De combinatie van trigger-endpoint en webhooks maakt het mogelijk om archivering volledig in te bedden in uw redactieworkflow. Publiceert of wijzigt een redacteur een pagina, dan stuurt uw CMS een trigger en ontvangt het kort daarna een bevestiging van de opname. Zo legt u belangrijke wijzigingen vast op het moment dat ze online komen, in plaats van te vertrouwen op een vaste planning achteraf.
Liever op een vast ritme werken? Dat kan náást de API: zie geplande archivering voor opnamen elke N uren, dagen, weken of maanden. Voor de toegang tot de opgeslagen bestanden zijn er aparte kanalen, zoals WebDAV-toegang. Meer praktische antwoorden vindt u op onze pagina met veelgestelde vragen.