API
Reinventar 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 |
|---|---|---|
| Orgadmin API | Taksonomi, kategorier, tjenestekatalog og tjenestesøk | Tjenestesøk |
| Ordre-API | Tilbud og ordre, fra forespørsel til godkjenning | Tilbud og ordre |
Miljøer
| Tjeneste | Miljø | Basis-URL |
|---|---|---|
| Orgadmin | Test/stage | https://test-api.sirktek.com/orgadmin/v1 |
| Orgadmin | Produksjon | https://api.sirktek.com/orgadmin/v1 |
| Ordre | Test/stage | Kommer, se under |
| Ordre | Produksjon | Kommer, se under |
Ordre-API-et har ennå ingen publisert produksjonsadresse. Stiene i dokumentasjonen er stabile. Ta kontakt med Sirktek for tilgang til testmiljøet.
Driftsstatus for tjenestene: status.sirktek.com (Åpner Sirktek-dokumentasjonen i samme fane)
Åpent og pålogget
Noen endepunkt er åpne og krever ingen innlogging:
GET /categories. Hele den offentlige taksonomien.GET /solutions. Offentlige tjenester, med søk på kategori.GET /providers. Leverandører med minst én offentlig tjeneste.
De åpne endepunktene er mellomlagret og har en rategrense per IP-adresse. Alt annet krever token. Se Autentisering.
Versjonering
Stiene følger mønsteret /<tjeneste>/v<hovedversjon>/…. Hovedversjonen står i
basis-URL-en. Den skal du låse i integrasjonen din, ikke bygge opp dynamisk.
Bakoverkompatible endringer skjer innenfor en hovedversjon. Brytende endringer
får et nytt versjonsnummer.
Kom videre
- Tjenestesøk. Finn tjenester for en kategori.
- Tilbud og ordre. HATEOAS-flyten steg for steg.
- 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 Sirktek.