Bygg med Skickamejl

Här finns startpunkten för utvecklare som vill skicka transaktionella mejl via API. Välj bibliotek för din stack, testa med Swagger och använd SDK:t eller MCP-servern när du vill komma igång snabbt.

API-bas

Lokalt använder du normalt http://localhost:5121. I produktion använder klienten den publika Skickamejl-basen.

Autentisering

REST och SDK använder X-Api-Key. MCP-klienter använder Authorization: Bearer. Lägg aldrig token i publik frontendkod.

Full referens

Swagger visar aktuella endpoints, requestmodeller och svar direkt från den körande appen.

JavaScript

Node.js eller modern JavaScript

Använd inbyggd fetch i Node 18+ eller installera ett HTTP-bibliotek om projektet redan använder det.

Installera valfria paket

npm install

# Om du vill använda axios i stället för fetch:
npm install axios

För frontendappar: skicka aldrig API-token från webbläsaren. Lägg anropet i din backend, server action eller edge-funktion.

Skicka med fetch

const response = await fetch("http://localhost:5121/api/messages", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": process.env.SKICKAMEJL_API_KEY
  },
  body: JSON.stringify({
    from: "no-reply@example.se",
    to: "kund@example.com",
    subject: "Din orderbekräftelse",
    textBody: "Tack för din beställning.",
    htmlBody: "<p>Tack för din beställning.</p>",
    messageStream: "transactional"
  })
});

if (!response.ok) {
  throw new Error(await response.text());
}
SDK

Utforska våra SDK-paket

Välj paket för din stack när du vill slippa bygga egna HTTP-anrop. SDK:erna använder serverns API-token i X-Api-Key och stöder både vanliga meddelanden och sparade mejlmallar.

Installera .NET-paketet

dotnet add package Skickamejl.Sdk

NuGet-paket: Skickamejl.Sdk

Källkod: skickamejl-sdk-dotnet på GitHub

Lägg nyckeln i user-secrets, miljövariabler eller din hemlighetshanterare, inte i källkod.

dotnet user-secrets set "Skickamejl:ApiKey" "<server-api-token>"
dotnet user-secrets set "Skickamejl:BaseUrl" "https://skickamejl.se/"

Skicka meddelande och mall

using Skickamejl.Sdk;

builder.Services.AddHttpClient("Skickamejl", (services, client) =>
{
    var configuration = services.GetRequiredService<IConfiguration>();
    client.BaseAddress = new Uri(
        configuration["Skickamejl:BaseUrl"] ?? "https://skickamejl.se/");
});

builder.Services.AddScoped(services =>
{
    var configuration = services.GetRequiredService<IConfiguration>();
    var apiKey = configuration["Skickamejl:ApiKey"]
        ?? throw new InvalidOperationException("Skickamejl:ApiKey saknas.");

    return new SkickamejlClient(
        services.GetRequiredService<IHttpClientFactory>().CreateClient("Skickamejl"),
        apiKey);
});

app.MapPost("/send-test", async (SkickamejlClient client) =>
{
    var message = await client.SendMessageAsync(new SendMessageRequest(
        From: "no-reply@example.se",
        To: "kund@example.com",
        Subject: "Test från .NET")
    {
        TextBody = "Det här är ett test.",
        HtmlBody = "<p>Det här är ett test.</p>",
        MessageStream = "transactional",
        Tag = "sdk-test"
    });

    var template = await client.SendTemplateMessageAsync(
        "orderbekraftelse",
        new SendTemplateMessageRequest(
            From: "no-reply@example.se",
            To: "kund@example.com")
        {
            Variables = new Dictionary<string, string>
            {
                ["customerName"] = "Anna",
                ["orderNumber"] = "12345"
            },
            MessageStream = "transactional",
            Tag = "order"
        });

    return Results.Accepted(value: new { message, template });
});

Installera Node-paketet

npm install @mrccollective/skickamejl-sdk

npm-paket: @mrccollective/skickamejl-sdk

Källkod: skickamejl-sdk-node på GitHub

Använd Node 18+ eller en runtime med fetch. Lägg API-token i miljövariabler eller din hemlighetshanterare.

SKICKAMEJL_API_KEY=<server-api-token>
SKICKAMEJL_BASE_URL=https://skickamejl.se/

Skicka meddelande och mall

import { SkickamejlClient } from "@mrccollective/skickamejl-sdk";

const client = new SkickamejlClient({
  baseUrl: process.env.SKICKAMEJL_BASE_URL ?? "https://skickamejl.se/",
  apiKey: process.env.SKICKAMEJL_API_KEY
});

const message = await client.sendMessage({
  from: "no-reply@example.se",
  to: "kund@example.com",
  subject: "Test från Node",
  textBody: "Det här är ett test.",
  htmlBody: "<p>Det här är ett test.</p>",
  messageStream: "transactional",
  tag: "sdk-test"
});

const template = await client.sendTemplateMessage("orderbekraftelse", {
  from: "no-reply@example.se",
  to: "kund@example.com",
  variables: {
    customerName: "Anna",
    orderNumber: "12345"
  },
  messageStream: "transactional",
  tag: "order"
});

console.log(message.messageId, template.messageId);
MCP

Snabbstart med MCP

Använd Skickamejls MCP-server när AI-agenter ska kunna skicka och granska transaktionella mejl via tydliga verktyg.

Anslutningsuppgifter

Endpoint
https://skickamejl.se/mcp
Autentisering
Authorization: Bearer <server-api-token>
Användning
Anslut AI-agenter som ska skicka eller inspektera transaktionella mejl.

Första gången en agent vill använda ett sändverktyg bör den be om bekräftelse innan verktyget körs.

mcp.json

{
  "mcpServers": {
    "skickamejl": {
      "type": "http",
      "url": "https://skickamejl.se/mcp",
      "headers": {
        "Authorization": "Bearer <server-api-token>"
      }
    }
  }
}

Exempel på agentprompt

Använd Skickamejls MCP-server för att skicka ett transaktionellt testmejl.
Mottagare: <mottagare@example.com>
Ämne: MCP-test
Text: Det här skickades via MCP.

Vid första sändningen bör agenten be om bekräftelse innan den använder MCP-verktyget.

Länkar

Nästa steg

Gå vidare till den tekniska referensen, SDK-paketen eller agentanpassade integrationsregler.

1

Swagger/OpenAPI

Se alla endpoints, parametrar och svar från den körande appen.

Öppna Swagger
4

MCP-server

Anslut agenter till Skickamejls MCP-endpoint med samma server API-token.

https://skickamejl.se/mcp
5

Agentguide

En kompakt integrationssida för AI-agenter och kodassistenter.

Öppna agentguiden