Expand description
The push service’s HTTP API (JSON).
| Method and path | Body | Answer |
|---|---|---|
POST /v1/register | Register | Registered |
POST /v1/rotate | Control | Registered (the old handle is revoked) |
POST /v1/unregister | Control | 204 |
POST /v1/wake | WakeRequest | 202, or 410 if the handle is unknown or revoked |
GET /v1/relay/announcements | bearer relay token | NDJSON stream of Announcement |
GET /v1/health | 200 ok |
Structs§
- Announcement
- One line of
GET /v1/relay/announcements. - Control
POST /v1/rotateandPOST /v1/unregister.- Error
Body - An error body.
- Register
POST /v1/register.- Registered
- A new handle and its control secret.
- Wake
Request POST /v1/wake.
Enums§
- Transport
- How the service reaches a device.