Integrasjoner

Bygg mot Peoply API-et

Peoply kan brukes som datakilde for arrangementer, foreninger og innlogging. Hvis du vil lage en egen klient, infoskjerm eller en intern tjeneste, starter du med API-dokumentasjonen.

Åpne API-dokumentasjon

Base URL: `https://api.peoply.app`

Slik kommer du i gang

1. Utforsk endepunktene

Swagger-dokumentasjonen viser request/response-modeller, query-parametre og hvilke endepunkter som krever innlogging.

2. Start med lesetilgang

De fleste integrasjoner begynner med å hente arrangementer og organisasjoner. Det gir deg en trygg read-only start.

3. Legg til auth ved behov

Hvis du trenger personaliserte data, må brukeren logge inn via Peoplys autentiseringsflyt og sende cookies videre i kallene.

Bra å vite

  • Respekter at noen endepunkter krever autentisering.
  • Organisasjoner kan også importere arrangementer via én offentlig .ics-URL fra org-innstillingene sine.
  • Alle organisasjonssider eksponerer også en egen .ics-feed du kan abonnere på fra kalenderappen din.
  • Cache read-only data der det gir mening.
  • Bygg mot stabile id-er og ikke kun visningstekst.
  • Bruk API-dokumentasjonen som kilde for felter og kontrakter.

Trenger du detaljene? Se hele dokumentasjonen i API-dokumentasjonen.

For produktspørsmål eller tilgangsbehov kan du også lese mer på FAQ-siden.

Hvis du administrerer en forening, kan du sette opp ICS-import på /orgs/<org>/settings. Peoply poller feeden og importerte arrangementer holdes låst som read-only.

Hvis du vil abonnere på Peoply-arrangementer fra en forening, finner du kalenderfeed direkte på organisasjonssiden.

Autentisering for beskyttede endepunkter

1. Send brukeren til login

Beskyttede endepunkter krever at brukeren logger inn via Peoplys eksisterende innlogging hos https://api.peoply.app/auth/login.

2. Bruk cookies videre

Etter vellykket innlogging setter backend auth-cookies. Videre kall til beskyttede endepunkter må derfor sendes med `credentials: include`, akkurat som frontend gjør i dag.

3. Håndter utløp

Hvis et kall svarer `401`, må klienten fornye sesjonen via `POST https://api.peoply.app/auth/refresh` og deretter prøve requesten igjen.

Kort fortalt: offentlige endepunkter kan leses direkte, mens beskyttede endepunkter krever Peoply-login, auth-cookies og refresh-flyt ved `401`.

Se hvilke endepunkter som er beskyttet og hvilke felter som kreves i API-dokumentasjonen.