notifications

GET /v1/notification-connections/confirm

What a confirmation link is asking.

Alle notifications Endpunkte

Authentifizierung

Dieser Endpunkt ist öffentlich. Er erfordert weder Anmeldedaten noch eine Organisation – er wird auch von unserer eigenen Marketing-Website und den KI-Antwort-Engines gelesen.

Dieser Endpunkt erfordert keine Organisations-ID. Ihr Schlüssel identifiziert bereits die zugehörige Organisation, und die Antwort ist entsprechend eingeschränkt.

Ausprobieren

Ersetzen Sie alles in spitzen Klammern durch Ihre eigenen Werte und den Platzhalter für den Schlüssel durch einen Schlüssel aus Ihrem Dashboard.

curl -X GET https://api.zinndigital.com/v1/notification-connections/confirm?token=<token>

Angemeldet? Die API-Konsole in Ihrem Dashboard trägt automatisch Ihre echte Organisations-ID sowie Ihren eigenen Schlüssel ein und führt die Anfrage gegen die Live-API aus, sodass Sie die tatsächliche Antwort sehen können. Öffnen Sie diesen Endpunkt in der API-Konsole

Details

Public and unauthenticated: the person clicking is very often an accountant or a colleague with no account here, and a confirmation behind a login wall cannot be completed by the one person it is addressed to. GET only DESCRIBES. Mail clients and scanners fetch links before a human sees them, so a confirming GET would be auto-clicked by the recipient's own mail infrastructure and double opt-in would silently become single opt-in. An unknown, expired or already-used token all answer `valid: false` identically - the endpoint must not become an oracle for which addresses an organisation has pending.

Parameter

NameTypErforderlichWas es ist
token (query)stringJa

Antwort

NameTypErforderlichWas es ist
validbooleanNein
emailstringNein
organisationstringNein