Skip to main content

Module unsubscribe

Module unsubscribe 

Source
Expand description

Leaving a mailing list in one click, on the network: the HTTPS POST of RFC 8058 (docs/client.md, “Unsubscribing”). When it may be sent is the core’s to say (sioul_core::unsubscribe); here it is sent as the RFC asks: List-Unsubscribe=One-Click as a form, no cookie, no authorisation, nothing of yours but what the list wrote in its own address. A redirect to another site is never followed; the wait is short.

Enums§

Outcome
What the list’s server made of the request.

Constants§

HOPS 🔒
Redirects followed within the same site (RFC 8058 asks senders for none).
WAIT
The longest the list’s server may take to answer, all told.

Functions§

authority_host 🔒
The host of an absolute address, lower case, without its port.
one_click
Posts List-Unsubscribe=One-Click to url, an HTTPS address of a name on the Internet (sioul_core::unsubscribe::host_of).
post 🔒
The request, and the redirects within host (a browser’s way: 303 and the older 301 and 302 continue as a GET, 307 and 308 post again).
resolve 🔒
Where a Location points, from base: an address of its own, one without its scheme (“//host/x”), or a path on the same site.
scheme 🔒
“https”, “http”: the scheme, lower case.