Render the unsubscribe confirmation page

Public, server-rendered HTML confirmation page for a signed unsubscribe token. No auth header — the HMAC-signed token in the path is the only gate. The page language is derived from the token’s locale snapshot / Accept-Language. Also cross-links to the preference center via a freshly minted token.

Auth: none (signed token in path). Token payload = { projectId, emailHash, category, exp, locale }, HMAC-signed with the server compliance key.

Parameters

Path Parameters

token

required

string

HMAC-signed compliance token identifying (projectId, emailHash).

Responses

200

Unsubscribe confirmation page (HTML).

text/html

string

400

Missing token, service misconfigured (no HMAC key), or the token is expired / invalid. Rendered as an HTML error page.

text/html

string

GET

/api/email/unsubscribe/{token}

1
curl --request GET \
2
  --url https://api.retidal.com/api/email/unsubscribe/%3Cstring%3E

1
const url = 'https://api.retidal.com/api/email/unsubscribe/%3Cstring%3E';
2
const options = {method: 'GET'};
3

4
try {
5
  const response = await fetch(url, options);
6
  const data = await response.json();
7
  console.log(data);
8
} catch (error) {
9
  console.error(error);
10
}

1
package main
2

3
import (
4
  "fmt"
5
  "net/http"
6
  "io"
7
)
8

9
func main() {
10

11
  url := "https://api.retidal.com/api/email/unsubscribe/%3Cstring%3E"
12

13
  req, _ := http.NewRequest("GET", url, nil)
14

15
  res, _ := http.DefaultClient.Do(req)
16

17
  defer res.Body.Close()
18
  body, _ := io.ReadAll(res.Body)
19

20
  fmt.Println(res)
21
  fmt.Println(string(body))
22

23
}