Moving from the first API
The mail host's /api/v1 and where each call went.
The first API (on the mail host, https://mail.zilomail.in/api/v1, organisation keys only) keeps working for 12 months, so nothing you built breaks. Its answers now say Deprecation: true with a link here. New work should use https://api.zilomail.in/v1.
| First API | Now |
|---|---|
POST /api/v1/send | POST /v1/mail/send |
POST /api/v1/send/batch | POST /v1/mail/send (one per message, with Idempotency-Key) |
GET /api/v1/messages/{id} | GET /v1/mail/send/{id} (delivery status) |
GET /api/v1/mailboxes | GET /v1/mail/mailboxes |
GET /api/v1/mailboxes/{address}/messages | GET /v1/mail/messages?mailbox={address} |
GET /api/v1/messages/{id}/content | GET /v1/mail/messages/{id} |
GET /api/v1/drive/files?user=… | GET /v1/drive/items (as the key's person) |
POST /api/v1/drive/files | POST /v1/drive/files |
GET /api/v1/users | GET /v1/people |
GET /invoice-host/api/v1/hr/employees | GET /v1/hr/employees |
What changed#
- One address for every app, one error shape, cursors for lists.
- Every request acts as a person: a key now names whom it acts as (existing keys act as the admin who made them; change it in Control).
- Apps for people sign in with ZiloOne instead of sharing a key.