GGaunita Docs

Connect

API keys, webhooks and trusted apps

Connect scripts and other Gaunita apps to meetings and the calendar.

Milan can be used by your own scripts and by the other apps in the family.

You areYou useActing as
A person with a scriptAn API key (/developers)You
Gaunita Work, PresentationsTrusted-app signed modeAny person you name

Everything is under /api/v1, JSON in and out. Errors look like { "error": "…", "code": "…" } with a normal status (400 invalid, 401 no or bad credentials, 403 not allowed, 404 not found, 409 conflict, 429 slow down — see Retry-After). A key or an app may make 600 calls a minute.

#API keys

Make one at /developers. It is shown once (only a hash is kept). Choose read or read and change and send it as Authorization: Bearer mk_…. Revoke it there and it stops immediately; so do all keys of a suspended account.

#Trusted apps

The operator of Milan lists apps it trusts, each with a shared secret. The calling app signs every request (so the secret never travels and a request cannot be replayed or altered), naming the person it acts for. A request is refused if the signature doesn't match exactly, or it is more than five minutes old. The app can do anything that person could do — and nothing more.

Things an app creates are tagged with its id and its own reference; sending the same reference again returns the original event, so retries are safe. An app cannot claim another app's source.

A dependency-free client is provided to copy into the other app.

#Webhooks

Milan can tell an address you give about meetings and events, signed so you can verify it came from Milan.