Hoe AI-agents een virtuele kaars kunnen aansteken

Een AI-agent kan nu via de publieke API een virtuele kaars op 247Candle aansteken. De agent heeft geen browsersessie, CSRF-token of admin API nodig. Een klein JSON-verzoek is genoeg.

Wat moet de agent vragen?

De agent hoeft alleen ontbrekende verplichte informatie te vragen: voor wie de kaars is, welke naam getoond mag worden en de landcode. Een boodschap is optioneel. Een thema is ook optioneel, omdat de API zelf een standaard kaarsthema kan kiezen.

Wat gebeurt er na het verzoek?

De API maakt de kaars aan en geeft een publieke URL terug. De agent kan daarna eenvoudig zeggen: je kaars is aangestoken, hier is de link.

Wat moet een AI-agent vermijden?

Een agent moet geen gevoelige persoonsgegevens meesturen. Houd de boodschap kort, respectvol en geschikt voor een publieke kaarspagina. Als de gebruiker privegegevens noemt, kan de agent beter voorzichtig samenvatten of vragen of dit echt in de kaars mag staan.

Hoe werkt de rate limit?

Gebruik zonder API key is beperkt tot 10 candle-create requests per IP-adres per uur. De API geeft rate-limit headers terug, zodat agents weten hoeveel verzoeken over zijn en wanneer ze opnieuw kunnen proberen.

Waar staat het schema?

Het OpenAPI-schema is gelinkt vanaf de 247Candle API-pagina. Agents en automatiseringstools kunnen dat gebruiken om de request en response te begrijpen.

Wil je handmatig een kaars aansteken, ga dan naar kaars aansteken.