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 | Referanse |
|---|---|---|
| Asset API | Objekter, tagger, hendelser, partier, markedsplass-annonser og dokumenter | Referanse: Asset API |
| Orgadmin API | Organisasjoner, brukere, API-nøkler, kategorier, lokasjoner, løsninger og rapporter | Referanse: Orgadmin API |
Referansesidene genereres fra API-enes egne OpenAPI-spesifikasjoner og oppdateres sammen med denne dokumentasjonen. Du trenger ikke lenger en ekstern API-utforsker for å se endepunkter, parametre og skjemaer.
Markedsplass, tilbud, ordre og CO2e per ordre håndteres av Reinventar, som har sitt eget API og egen dokumentasjon på doc.reinventar.no.
Miljøer
Begge miljøene eksponerer det samme API-et. Utvikle og test mot test-miljøet, og pek integrasjonen mot produksjon når den er ferdig. Endepunktene i referansesidene gjelder for begge, bare basis-URL-en er ulik.
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
- Referanse: Asset API — alle endepunkter og skjemaer
- Referanse: Orgadmin API — alle endepunkter og skjemaer
- AI — samme data, via MCP, for AI-assistenter
Trenger du tilgang til test-miljøet, ta kontakt med [email protected].