Hoppa till innehållet

API och integrationer Headless commerce Nyhetsbrev

English

Nyhetsbrev

Newsletter sign-up with double opt-in, and one-click unsubscribe per RFC 8058. The unsubscribe endpoint is quota'd per token rather than per IP, because mail providers share addresses across many recipients.

3 anrop POST Bas-URL https://api.erp.fluit.cloud/ecom

Autentisering, felkoder, rate limits, idempotens och paginering gäller alla anrop och står samlade under Kom igång.

POST /newsletter/confirm

Confirm newsletter subscription

Confirms a pending newsletter subscription using the token from the confirmation email. The token is consumed and cannot be reused.

Body krävs

Fält Typ
token string · nullable

Svar

200 ConfirmNewsletterSubscriptionResponse
Fält Typ
email string · nullable

Standardfel: 400 404 409 429 Felhantering

Exempel

curl 
curl -X POST "https://api.erp.fluit.cloud/ecom/newsletter/confirm" \
  -H "X-Tenant-Id: $FLUIT_TENANT_ID" \
  -H "X-Channel: web" \
  -H "Content-Type: application/json" \
  -d @body.json
Svar 200 
{
  "email": "order@acme.se"
}

Bas-URL https://api.erp.fluit.cloud/ecom. Svarsexemplet är genererat ur schemat: formen stämmer, värdena är påhittade.

POST /newsletter/subscribe

Subscribe to newsletter

Signs an email address up for the channel newsletter. Always double opt-in: a confirmation email is sent and the subscription is not mailable until the link is followed.

Body krävs

Fält Typ Beskrivning
captchaToken string · nullable
consentText string · nullable Den exakta text som visades bredvid fältet. Butiken skickar med den så att samtycket går att belägga i efterhand — texten sparas ordagrant.
email string · nullable
formLoadedAtUnixMs integer · nullable
honeypot string · nullable
language string · nullable
name string · nullable

Svar

200 SubscribeToNewsletterResponse
Fält Typ
confirmationSent boolean

Standardfel: 400 404 429 Felhantering

Exempel

curl 
curl -X POST "https://api.erp.fluit.cloud/ecom/newsletter/subscribe" \
  -H "X-Tenant-Id: $FLUIT_TENANT_ID" \
  -H "X-Channel: web" \
  -H "Content-Type: application/json" \
  -d @body.json
Svar 200 
{
  "confirmationSent": true
}

Bas-URL https://api.erp.fluit.cloud/ecom. Svarsexemplet är genererat ur schemat: formen stämmer, värdena är påhittade.

POST /newsletter/unsubscribe

Unsubscribe from newsletter

Withdraws newsletter consent using the token from an email, passed as a query parameter. Requires no login — one-click unsubscribe per RFC 8058. Idempotent; any request body is ignored.

Frågeparametrar

Fält Typ
token string

Svar

200 UnsubscribeFromNewsletterResponse
Fält Typ
unsubscribed boolean

Standardfel: 400 404 429 Felhantering

Exempel

curl 
curl -X POST "https://api.erp.fluit.cloud/ecom/newsletter/unsubscribe" \
  -H "X-Tenant-Id: $FLUIT_TENANT_ID" \
  -H "X-Channel: web"
Svar 200 
{
  "unsubscribed": true
}

Bas-URL https://api.erp.fluit.cloud/ecom. Svarsexemplet är genererat ur schemat: formen stämmer, värdena är påhittade.