# Skyra API

Canonical: https://www.skyra.no/no/help/skyra-api

Language: no

Lær hvordan du bruker Skyra API til å hente ut rapportdata, aggregerte resultater og rådata fra undersøkelsene dine.

Skyra har et API som lar deg hente ut data fra undersøkelsene dine direkte – uten å gå via appen.

![Illustrasjon: Skyra API](<https://cdn.sanity.io/images/tjuxddem/production/d7c7e43c8675a92f1db07486dd3096bf9cfb15b4-1300x670.png?fit=max&auto=format>)

<a id="h_6ad469c613"></a>

## Dokumentasjon

> [!WARNING]
> 📄 **API-dokumentasjon finnes her:**  
> ​**[api.skyra.no/docs/api/beta](<https://api.skyra.no/docs/api/beta>).**

<a id="h_0306999b91"></a>

### Aktivering

API-et kan aktiveres ved forespørsel til Skyra-teamet. Ta kontakt med oss på [**support@skyra.no**](<mailto:support@skyra.no>), om du ønsker tilgang.

<a id="h_bc98bec035"></a>

## API-nøkler og tilganger

Når du får en API-nøkkel, kan den konfigureres med følgende tilganger:

- **Response text access** – Bestemmer om nøkkelen kan lese fritekststsvar, for eksempel fra _Input Card_.  
​
- **Allowed surveys** – Begrenser hvilke undersøkelser nøkkelen har tilgang til. Hvis ingen undersøkelser er valgt, kan nøkkelen lese alle undersøkelser i workspacet.

<a id="h_910dc5ea44"></a>

## Hva kan du hente ut?

API-et er delt inn i fem kategorier:

1. **Discovery** – Finn ID-er til undersøkelser, kort, segmenter og andre ressurser. Start her for å finne ID-ene du trenger i andre kall. Disse endepunktene returnerer metadata og er ikke for analyse.  
​
2. **Card Reports** – Rapportdata per kort, tilsvarende det du ser i rapport-visningen i Skyra-appen. Støtter filtrering på datoperiode, enhet, segment med mer.  
​
3. **Survey Reports** – Aggregerte tall for undersøkelser: sammendrag, trender, tag- og trait-fordeling og mer. Disse leser fra forhåndsaggregerte tabeller og støtter kun datofilter.  
​
4. **Task Reports** – Aggregerte tall for Top Task-undersøkelser, inkludert workspace-wide leaderboard og trender på tvers av oppgaver.  
​
5. **Raw Data** – Rå responser rad for rad, tilsvarende _All responses_ i appen. Støtter paginering og er nyttig for eksport og egen databehandling.  


<a id="h_fdde99d92c"></a>

## Eksempel: Hent rapport for en undersøkelse

**Steg 1 – Finn ID-en til undersøkelsen din:**

```bash
curl "https://api.skyra.no/beta/surveys" \
  -H "Authorization: Bearer <api-key>"
```

**Steg 2 – Hent rapporten:**

```bash
curl -X POST "https://api.skyra.no/beta/reports/survey/<surveyId>" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{"filters":{"startDate":"2025-01-01T00:00:00Z","endDate":"2025-12-31T23:59:59Z"}}'
```

## I disse samlingene

- [Settings (hovedmeny)](<https://www.skyra.no/no/help/settings-hovedmeny.md>) — Forklaring av settings