Services
Mail – Brand anlegen
Lege eine Marke an (Logo/Header/Footer, Absenderdaten), die beim Versand genutzt werden kann.
Route
- Methode: POST
- URL: /api/mail/create-brand
- Auth:
x-api-key
(Header)
Request
- name: string
- company: string
- replyTo: string (E‑Mail)
- html: string (Header/Footer‑HTML)
/api/mail/create-brand (POST)
{
"name": "Acme",
"company": "Acme GmbH",
"replyTo": "acme@example.com",
"html": "<header>...</header><footer>...</footer>"
}
curl -X POST "https://dev.nuvisphere.de/api/mail/create-brand" \
-H "Content-Type: application/json" \
-H "x-api-key: API_KEY"
-d '{
"name": "Acme",
"company": "Acme GmbH",
"replyTo": "acme@example.com",
"html": "<header>...</header><footer>...</footer>"
}'
// server-side (Node/Next.js)
const res = await fetch("https://dev.nuvisphere.de/api/mail/create-brand", {
method: "POST",
headers: {
"content-type": "application/json",
"x-api-key": process.env.MAILER_API_KEY!,
},
body: JSON.stringify({
"name": "Acme",
"company": "Acme GmbH",
"replyTo": "acme@example.com",
"html": "<header>...</header><footer>...</footer>"
}),
});
if (!res.ok) throw new Error(`Request failed ${res.status}`);
const json = await res.json();
- API Key niemals im Browser verwenden – nur serverseitig (z. B.
process.env.MAILER_API_KEY
). - Lässt du optionale Felder weg, nutzt die API ggf. Template-/Defaultwerte.
Response
{
"ok": true,
"id": "BRAND_ID"
}