Perusteet
Sallitut HTTP-verbit ovat GET, PATCH, POST ja DELETE. Tässä tarkemmat kuvaukset kutsutyypeistä:
- GET: Tietojen hakeminen Severasta
- PATCH: Olemassa olevan tiedon päivittäminen
- JSON Patch on muoto, jota käytetään tietoja päivitettäessä REST API:ssa (lisätietoja osoitteessa: http://jsonpatch.com/).
- Vain Replace (korvaa) on tuettu.
- POST: Ny informasjon opprettet i Severa
- DELETE: Fjerning av informasjon fra Severa.
- Bruk med forsiktighet, da slettede data fjernes helt
- Kutsujen vastauskoodeja ovat Success, Created ja Bad request
Sivutus
Oletuksena jokaista GET-kutsua kohden haetaan 20 riviä, ja maksimi on 1000. Parametrit ovat firstRow ja rowCount. Suositellaan käytettäväksi raskaissa kutsuissa.
Tekstin haku
Parametria textToSearch voidaan käyttää nopeaan hakuun. Esimerkiksi GET/users kutsussa on parametri, jolla voi hakea käyttäjän nimestä, koodista, e-postista tai avainsanoista. Kunkin reitin osalta kentät, joista haku suoritetaan, on määritelty teknisessä dokumentaatiossa.
Lajittelu
Määritelty monissa GET all for reiteissä kyselyparametrina. Se tukee useiden arvojen antamista. Eksempel:
- ?sortings[0]
- [key]=lastUpdatedDateTime&sortings[0]
- [value]=Desc&sortings[1]
- [key]=createdDateTime&sortings[1]
- [value]=Asc
Changed since
Parametri tietojen hakemiseen tietystä päivämäärästä eteenpäin. Tämän parametrin avulla voit hakea tietoja, jotka on muutettu annetun päivämäärän jälkeen. Esimerkiksi GET/users kutsussa on ChangedSince-parametri, jolla saa brukere, jotka on lagt til tai muutettu tämän päivämäärän jälkeen (suurempi tai yhtä suuri kuin).
Laajuudet (Scopes)
Tällä hetkellä aktivert on vain SeveraAll, mutta laajuuksia lisätään niiden implementoinnin myötä.
Var dette svaret til hjelp? Ja Nei
Send feedback