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 are | You use | Acting as |
|---|---|---|
| A person with a script | An API key (/developers) | You |
| Gaunita Work, Presentations | Trusted-app signed mode | Any 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.