Partner-API

Send arrangementer til Duito fra deres eget system. Ett endepunkt, JSON inn og ut, og samme ID oppdaterer i stedet for å lage duplikater.

Kom i gang

1. Registrer organisasjonen på duito.net/partner (se Kom i gang).
2. Lag en API-nøkkel i portalen. Den vises bare én gang, så lagre den trygt.
3. Send arrangementer som vist under. Før partneren er godkjent, svarer API-et 403 PARTNER_PENDING_APPROVAL.

Autentisering

Send nøkkelen i headeren X-Partner-Api-Key på hvert kall. Bruk alltid HTTPS, og hold nøkkelen på serversiden. Den skal aldri ligge i en nettside eller app som brukerne laster ned.

X-Partner-Api-Key: duito_pk_3f9a...

Opprett eller oppdater et arrangement

POST https://api.duito.net/partner/events

Kallet er idempotent på externalId. Første gang opprettes arrangementet, og senere kall med samme externalId oppdaterer det. Send hele arrangementet hver gang, ikke bare feltene som er endret.

Felter

Eksempel med curl

curl -X POST https://api.duito.net/partner/events \
  -H "X-Partner-Api-Key: duito_pk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "konsert-2026-11-14",
    "title": "Høstkonsert med Mandal kammerkor",
    "description": "Årets høstkonsert med verk av Grieg og Sommerro.",
    "category": "musikk",
    "startsAt": "2026-11-14T19:00:00+01:00",
    "endsAt": "2026-11-14T21:00:00+01:00",
    "location": { "lat": 58.0294, "lng": 7.4609, "label": "Buen kulturhus, Mandal" },
    "ticketUrl": "https://dere.no/billetter/hostkonsert",
    "coverImageUrl": "https://dere.no/bilder/hostkonsert.jpg",
    "tags": ["Kor", "Klassisk"]
  }'

Eksempel i JavaScript

const res = await fetch("https://api.duito.net/partner/events", {
  method: "POST",
  headers: {
    "X-Partner-Api-Key": process.env.DUITO_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    externalId: event.id, // deres egen ID - samme ID oppdaterer
    title: event.title,
    category: "musikk",
    startsAt: event.start.toISOString(),
    location: { lat: event.lat, lng: event.lng, label: event.venueName },
    ticketUrl: event.ticketUrl,
  }),
});
if (!res.ok) {
  const { error } = await res.json();
  throw new Error(`${error.code}: ${error.message}`);
}

Svar

Feil

Alle feil har samme format:

{ "error": { "code": "INVALID_CATEGORY", "message": "Ukjent kategori" } }

Kategorier

Hent gjeldende kategorier fra GET https://api.duito.net/categories (offentlig, ingen nøkkel). Bruk slug-verdien i category. Lista kan utvides, så les den fra endepunktet i stedet for å hardkode den. Per i dag:

Bruk gjerne tags for å beskrive arrangementet mer presist enn kategorien.

Grenser og god praksis

• Maks 100 kall per minutt. Synkroniserer dere mange arrangementer, send dem ett og ett med litt mellomrom.
• Send arrangementet på nytt når noe endres. Det er trygt å sende det samme flere ganger.
• Bruk en stabil externalId. Endres den, blir det et nytt arrangement.
• Bildelenker må være offentlig tilgjengelige og peke rett på bildet.
• Få avlyste arrangementer ut av Duito ved å kontakte oss inntil videre. Kalenderlenken håndterer avlysning automatisk.