API integrasjon
Sirktek tilbyr dokumenterte REST-API-er for integrasjon med eksterne systemer. Alt klientene på plattformen gjør, gjør de mot de samme API-ene du har tilgang til — det finnes ikke et privat API bak.
To tjenester er relevante:
| Tjeneste | Hva den dekker |
|---|---|
| Asset API | Objekter, hendelser, avvik og dokumenter |
| Orgadmin API | Organisasjoner, brukere, kategorier og taksonomi |
Miljøer
| Tjeneste | Miljø | Basis-URL | API-utforsker | Status |
|---|---|---|---|---|
| Asset | Test/stage | https://test-api.sirktek.com/assets/v2 | Swagger UI | |
| Asset | Produksjon | https://api.sirktek.com/assets/v2 | Ikke publisert | |
| Orgadmin | Test/stage | https://test-api.sirktek.com/orgadmin/v1 | Swagger UI | |
| Orgadmin | Produksjon | https://api.sirktek.com/orgadmin/v1 | Ikke publisert |
Produksjonsmiljøet publiserer ingen interaktiv API-utforsker. Bruk test-miljøet til å utforske API-et, og pek integrasjonen mot produksjon når den er ferdig.
Driftsstatus for tjenestene: status.sirktek.com
Versjonering
Stiene følger mønsteret /<tjeneste>/v<hovedversjon>/…. Hovedversjonen står i
basis-URL-en, og den skal du låse i integrasjonen din — ikke bygge den opp
dynamisk. Bakoverkompatible endringer skjer innenfor en hovedversjon; brytende
endringer får et nytt versjonsnummer.
Kom videre
- Autentisering — token, headere og API-nøkler
- Feilhåndtering — hva 401 og 403 betyr her
- AI — samme data, via MCP, for AI-assistenter
Trenger du tilgang til test-miljøet, ta kontakt med [email protected].