API
VARDLY er en klient på Sirktek-plattformen. Alt appen gjør, gjør den mot de samme REST-API-ene du har tilgang til — det finnes ikke et privat API bak.
To tjenester er relevante:
| Tjeneste | Hva den dekker | Referanse |
|---|---|---|
| Asset API | Eiendommer, kontrollpunkt, kontrollrunder, hendelser, avvik og dokumenter | Endepunkter og skjemaer |
| Orgadmin API | Organisasjoner, kategorier og taksonomi | Kommer |
Miljøer
| Tjeneste | Miljø | Basis-URL |
|---|---|---|
| Asset | Test/stage | https://test-api.sirktek.com/assets/v2 |
| Asset | Produksjon | https://api.sirktek.com/assets/v2 |
| Orgadmin | Test/stage | https://test-api.sirktek.com/orgadmin/v1 |
| Orgadmin | Produksjon | https://api.sirktek.com/orgadmin/v1 |
Vil du prøve kallene interaktivt, publiserer test-miljøet en Swagger UI: Asset og Orgadmin. Produksjonsmiljøet publiserer ingen interaktiv API-utforsker — bruk test-miljøet til å utforske, og pek integrasjonen mot produksjon når den er ferdig.
Driftsstatus for tjenestene: status.sirktek.com (Åpner Sirktek-dokumentasjonen i samme fane)
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
- Referanse: Asset API — endepunkter og skjemaer
- AI — samme data, via MCP, for AI-assistenter
Trenger du tilgang til test-miljøet, ta kontakt med Sirktek.