Golang Wrapper für PROFFIX REST-API

Installation

go get github.com/pitwch/go-wrapper-proffix-restapi/proffixrest

Konfiguration

import (  px"github.com/pitwch/go-wrapper-proffix-restapi/proffixrest")varpxrest,err=px.NewClient("https://myserver.ch:999","USR","b62cce2fe18f7a156a9c719c57bebf0478a3d50f0d7bd18d9e8a40be2e663017","DEMO", []string{"ADR","FIB"},&px.Options{},)

Optionen

Methoden

Get / Query

//Contextctx:=context.Background()//Einfache Abfragerc,_,statuscode,err:=pxrest.Get(ctx,"ADR/Adresse/1", url.Values{})//Abfrage mit Parameternparam:= url.Values{}param.Set("Filter","Vorname@='Max'")rc,_,statuscode,err:=pxrest.Get(ctx,"ADR/Adresse",param)

Put / Update

$pxrest=newClient(...)vardatamap[string]interface{}=map[string]interface{}{"Name":"Muster GmbH","Ort":"Zürich","Zürich":"8000", }rc,header,statuscode,err:=pxrest.Put(ctx,"ADR/Adresse",data)

Patch / Update

$pxrest=newClient(...)vardatamap[string]interface{}=map[string]interface{}{"Ort":"Zürich","Zürich":"8000", }rc,header,statuscode,err:=pxrest.Patch(ctx,"ADR/Adresse/1",data)

Post / Create

vardatamap[string]interface{}=map[string]interface{}{"Name":"Muster GmbH","Ort":"Zürich","Zürich":"8000", }//Query Endpoint ADR/Adresse with Headersrc,header,statuscode,err:=pxrest.Post(ctx,"ADR/Adresse",data)

Delete / Delete

//Delete Endpoint ADR/Adresse with Headers_,_,_,err=pxrest.Delete(ctx,"ADR/Adresse/2")

Response / Antwort

// Returns no Header (_)rc,_,_,err:=pxrest.Get(ctx,"ADR/Adresse/1", url.Values{})

// Returns Headerrc,header,_,err:=pxrest.Post(ctx,"ADR/Adresse/1",data)// Print Header->Locationfmt.Print(header.Get("Location"))

rc,header,_,err:=pxrest.Get(ctx,"ADR/Adresse/1", url.Values{})buf:=new(bytes.Buffer)buf.ReadFrom(rc)resp:=buf.String()fmt.Printf(resp,err)deferrc.Close()

Fehlerhandling / Error

// Query with Errorrc,_,_,err:=pxrest.Get(ctx,"ADR/Adresse/xxx", url.Values{})fmt.Print(err.(*PxError).Message)// Message fieldfmt.Print(err.(*PxError).Status)// Status fieldfmt.Print(err.(*PxError).Fields)// Failed fields

Spezielle Endpunkte

Logout

statuscode,err:=pxrest.Logout(ctx)

Info

rc,err:=pxrest.Info(ctx,"112a5a90fe28b23ed2c776562a7d1043957b5b79fad242b10141254b4de59028")// Buffer decode for plain text responsebuf:=new(bytes.Buffer)buf.ReadFrom(rc)resp:=buf.String()fmt.Printf(resp,err)deferrc.Close()

Datenbank

rc,err:=pxrest.Database(ctx,"112a5a90fe28b23ed2c776562a7d1043957b5b79fad242b10141254b4de59028")// Buffer decode for plain text responsebuf:=new(bytes.Buffer)buf.ReadFrom(rc)resp:=buf.String()fmt.Printf(resp,err)deferrc.Close()

ServiceLogin

pxrest.ServiceLogin(ctx,"7e024696-49e4-e54e-1a20-ffc0ba9a1374")

PRO/Datei bzw. File Upload

fp:="C:/test.png"file,err:=ioutil.ReadFile(fp)rc,headers,status,err:=pxrest.File(ctx,"Demofile.png",file)// Buffer decode for plain text responsebuf:=new(bytes.Buffer)buf.ReadFrom(rc)resp:=buf.String()fmt.Printf(resp,err)deferrc.Close()// Get temporary filename from Headersid:=proffixrest.ConvertLocationToID(headers)

PRO/Datei bzw. File Download

rc,filename,_,_,err:=px.GetFile(ctx,"9PnrK4XiFzyrTdDK9HHLE80Kk2lARKS5Ppn2WNrOPqGHzCREYtidmRhUKXq-82uSvDerMckkcB3srYn9TsKvk0C1P9ca3deIeMzp5jiaeIwT4wgnH0qarwdny17-8eGq",nil)px.WriteFile(filename,rc)

GET Batch

//Set Paramsparams:= url.Values{}params.Set("Fields","AdressNr,Name,Ort,Plz")//GET Batch on ADR/Adressen with Batchsize = 35rc,total,err:=pxrest.GetBatch(ctx,"ADR/Adresse",params,35)//Returns all possible results in `rc`, the complete amount of results as int in `total` and//possible errors in `err`

Sync Batch

//First entry has AdressNr and exist -> PUT, second has no AdressNr -> POSTjsonExample:=`[{                    "AdressNr": 276,                    "Name": "EYX AG",                    "Vorname": null,                    "Strasse": "Zollstrasse 2",                    "PLZ": "8000",                    "Ort": "Zürich"                   }, {                    "Name": "Muster",                    "Vorname": "Hans",                    "Strasse": "Zürcherstrasse 2",                    "PLZ": "8000",                    "Ort": "Zürich"                   }]`created,updated,failed,errors,total,err:=pxrest.SyncBatch(ctx,"ADR/Adresse","AdressNr",true,[]byte(jsonExample))//Results//      created -> [333]//      updated -> [276]//      failed -> []//      errors -> []//      total -> 2//      err -> nil

GET List

//Get Filefile,headers,status,err:=pxrest.GetList(ctx,"ADR_Adress-Etiketten Kontakte.labx",nil)//Write Filepx.WriteFile("C://test//test.pdf",file)//Hilfsfunktion um Dateien zu schreiben

CheckApi

//CheckApierr:=pxrest.CheckApi(ctx)

Hilfsfunktionen

ConvertPXTimeToTime

t:=ConvertPXTimeToTime('2004-04-1100:00:00')

ConvertTimeToPXTime

t:=ConvertTimeToPXTime(time.Now())

ConvertLocationToID

id:=ConvertLocationToID(header)

WriteFile

px.WriteFile("C://test//test.pdf",file)

CMD / Docker

Weitere Beispiele