Udviklere

Partner API

beta

Integrér med Launchr. API’et er i beta — endpoints kan ændre sig, og vi versionerer under /v1, så jeres integration ikke brydes uden varsel.

Kom i gang

Alle kald sker over HTTPS mod base-URL https://launchr.dk/api/v1. Autentificér med en API-nøgle i en Authorization-header. Nøgler oprettes inde i Launchr under Indstillinger → Partner-API; hver nøgle giver kun adgang til sin egen organisations data og kan tilbagekaldes når som helst.

curl https://launchr.dk/api/v1/me \
  -H "Authorization: Bearer lk_…"

Endpoints

GET/me— Hvem er jeg

Bekræfter at nøglen virker og returnerer den organisation den tilhører. Kald dette først for at teste opsætningen.

Eksempel-svar

{
  "meta": {
    "version": "v1",
    "status": "beta"
  },
  "data": {
    "organization": {
      "id": "org_…",
      "name": "Eksempel A/S"
    }
  }
}

GET/orders— Hent ordrer

Returnerer organisationens medie-køb (op til 100, nyeste først) i et stabilt felt-udsnit.

Eksempel-svar

{
  "meta": {
    "version": "v1",
    "status": "beta"
  },
  "data": {
    "orders": [
      {
        "id": "…",
        "providers": [
          "tv2_connect",
          "viaplay"
        ],
        "advertiserName": "Annoncørens navn",
        "campaignName": "Kendskab Q2",
        "budgetDkk": 50000,
        "startDate": "2026-06-01",
        "endDate": "2026-06-21",
        "status": "ordered",
        "externalReference": "VIA-12345",
        "createdAt": "2026-05-21T10:00:00.000Z"
      }
    ]
  }
}

Fejl og versionering

Fejl returneres med en passende HTTP-statuskode og et JSON-objekt med et error.message-felt. En manglende eller ugyldig nøgle giver 401. Alle svar indeholder et meta-felt med version og status (beta).

Hele beskrivelsen findes maskinlæsbart som OpenAPI 3.1-spec — importér den i Postman eller generér en klient.

Vil I integrere? Skriv til hello@launchr.dk, så finder vi den bedste model sammen.