API SkriveAPI
Data kan skrives til KB via enten PUT eller POST.
Dette er kun aktiveret på udvalgte tabeller. Bemærk, det er ikke alle data, der kan ændres. Fx kan en Kunde.Saldo eller andre beregnede felter ikke ændres. Der returneres altid det opdaterede objekt.
Opdatering (PUT)
PUT bruges til at opdatere en eksisterende record.
Recorden, der kan hentes med
GET
https://demo.keybalance.dk/demo/API2/50229EA9-A883-45DD-A19F-D7ACCACB1891/Debitorer/06011535
kan altså opdateres via et tilsvarende object på (id objektet kan fint udelades/ignoreres i den kode som put'es)
PUT
https://demo.keybalance.dk/demo/API2/50229EA9-A883-45DD-A19F-D7ACCACB1891/Debitorer/06011535
Vi anvender ikke PATCH, men det er muligt at delopdatere via PUT. Det er kun felter, der er med i objektet, der bliver opdateret. Så udeladte felter forbliver uændret, felter som medtages tomme blive derimod tømt.
Retursvar er den rettede post
Opret (POST)
Nye Objekter oprettes ved at POST’e dem til listen. Altså samme Kunde Object- struktur som hentet ovenfor. ID bliver ignoreret, og ofte vil løbenumre etc. blive sat backend, det er forskelligt fra system til system, om fx varenumre eller kundenumre sættes backend eller med i kaldet.
POST
https://demo.keybalance.dk/demo/API2/50229EA9-A883-45DD-A19F-D7ACCACB1891/Debitorer
Body:
{
"Kontonr": "",
"Søgenavn": "",
"SE_Nr": "",
"Navn": "API opret test",
"SaldoVal": 30,
"Valuta": "",
"Adr1": "",
"Adr2": "Hhhhhhh asdsad",
"PostNr": "4566",
"ByNavn": "Gggg"
}
Retursvar er den oprettede post
Slet (DELETE)
Objekter slettes med DELETE.
Dette kan tage noget tid, da databasen skal sikre, at posten kan slettes, inden der returneres ok.
Det er ikke sikkert at posten kan slettes! Den kan være i brug. Så returneres fejl:
DELETE
https://demo.keybalance.dk/demo/API2/50229EA9-A883-45DD-A19F-D7ACCACB1891/Debitorer/06011535