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.

Öppna Swagger Visa .NET SDK Visa på GitHub

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());
}
.NET

Skickamejl .NET SDK

Använd SDK:t i C#-projekt i stället för att bygga egna HTTP-anrop. SDK:t skickar serverns API-token med X-Api-Key och hanterar svar från meddelande-API:t.

Installera SDK:t

dotnet add package Skickamejl.Sdk

Läs koden och versionshistoriken i skickamejl-sdk-dotnet på GitHub.

NuGet-paketet heter Skickamejl.Sdk.

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/"

Registrera och anropa SDK-klienten

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 response = 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"
    });

    return Results.Accepted(value: response);
});
MCP

MCP quick start

Use the Skickamejl MCP server to connect AI agents to send and inspect transactional emails.

Connection details

Endpoint
https://skickamejl.se/mcp
Auth
Authorization: Bearer <server-api-token>
Use case
Connect AI agents to send and inspect transactional emails.

The first time an agent wants to call a sending tool, it should ask for approval before using the tool.

mcp.json

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

Example agent prompt

Use the Skickamejl MCP server to send a test transactional email to <recipient@example.com> with subject "MCP test" and text body "This was sent through MCP."

For the first send action, the agent should ask for confirmation before it uses the MCP tool.

Länkar

Nästa steg

Gå vidare till den tekniska referensen, källkoden 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 remote MCP-endpoint med samma server API-token.

https://skickamejl.se/mcp
5

Agentguide

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

Öppna agentguiden