Zum Inhalt

Benutzer

Mit dieser Api werden die Benutzer ausgegeben.

Hinweis

Aktuell wird nur die Facette "personal" unterstützt. Siehe Facette addresses

Felder

property title default type examples
uid Benutzer ID 0 integer 20
name Banutzername string b2c@example.com
state Status 0 integer 0
creation Erstelldatum null
lastupdate Änderungsdatum string 2017-02-01T21:53:06
ranking Gewichtung string 0
erpID ERP ID string
erpName ERP Name string
erpNumber ERP Nummer string
erpLastUpdate ERP Änderungsdatum string 2013-12-15T16:43:53
erpCreation ERP Erstelldatum string 0000-01-01T00:00:00
archived archiviert string 0

Einen Benutzer auslesen

Die URL /api/account/user/[uid] liefert einen Benutzer zurück

{
    "dataset": {
        "39887013-301b-4f06-a3ca-096b109c9e86": {
            "uid": 20,
            "name": "[email protected]",
            "state": 0,
            "creation": null,
            "lastupdate": "2017-02-01T21:53:06",
            "erpID": "",
            "erpName": "",
            "erpNumber": "",
            "erpLastUpdate": "0000-01-01T00:00:00",
            "erpCreation": "0000-01-01T00:00:00",
            "archived": "0",
            "ranking": "0"
        }
    },
    "sys": {
        "pagination": {
            "total": 1,
            "currentPage": 1,
            "objectsPerPage": 20,
            "offset": 0,
            "nextOffset": null,
            "prevOffset": null,
            "pages": 1
        },
        "message": "200 OK",
        "code": 200
    }
}

Einen Benutzer anlegen

Mit der Methode POST auf die URL /api/account/user kann der Benutzer angelegt werden.

{
    "dataset": [
         {
            "name": "user1"
        },{
            "name": "user2",
            "state":2
        }
    ]
}

b4cfa8b9-d9ec-41d3-d2fc-4e1b34134f56

{
    "dataset": [
        {
            "sys": {
                "message": "201 Created",
                "code": 201,
                "created": "2018-08-11T04:33:29"
            },
            "dataset": {
                "name": "user1",
                "state": "0",
                "lastupdate": "0000-00-00 00:00:00",
                "archived": "0",
                "ranking": "0",
                "uid": "51"
            }
        },
        {
            "sys": {
                "message": "201 Created",
                "code": 201,
                "created": "2018-08-11T04:33:29"
            },
            "dataset": {
                "name": "user2",
                "state": 2,
                "lastupdate": "0000-00-00 00:00:00",
                "archived": "0",
                "ranking": "0",
                "uid": "52"
            }
        }
    ],
    "sys": {
        "message": "201 Created",
        "code": 201
    }
}

Einen Benutzer ändern

Mit der Methode PUT auf die URL /api/account/user kann der Benutzer geändert werden.

Hinweis

Bei Änderungen muss immer der komplette Datensatz übergeben werden, die Felder die nicht übergeben werden, werden gelöscht.

{
    "dataset": [
      {
            "uid": 20000,
            "namename": "[email protected]",
            "state": 0,
            "creation": null,
            "lastupdate": "0000-01-01T00:00:00",
            "erpID": "",
            "erpName": "",
            "erpNumber": "",
            "erpLastUpdate": "2011-02-19T21:02:31",
            "erpCreation": "0000-01-01T00:00:00",
            "archived": "0",
            "ranking": "0",
            "personal": {
                "dataset": {
                    "erpID": "",
                    "erpName": "",
                    "erpNumber": "",
                    "erpLastUpdate": "2018-03-16T12:03:34",
                    "erpCreation": "0000-01-01T00:00:00",
                    "pid": 19037,
                    "uid": 20000,
                    "alias": "",
                    "formOfAddress": "Herr",
                    "salutation": "",
                    "firstname": "Max",
                    "name1": "Mustermann",
                    "name2": "",
                    "title": "",
                    "custom1": "",
                    "custom2": "",
                    "birthday": "0000-01-01T00:00:00",
                    "lastUpdate": "0000-01-01T00:00:00"
                }
            }
      }
        ]
}

Antwort

{
    "dataset": [
        {
            "dataset": {
                "uid": 20000,
                "namename": "[email protected]",
                "state": 0,
                "creation": null,
                "lastupdate": "0000-01-01T00:00:00",
                "erpID": "",
                "erpName": "",
                "erpNumber": "",
                "erpLastUpdate": "2011-02-19T21:02:31",
                "erpCreation": "0000-01-01T00:00:00",
                "archived": "0",
                "ranking": "0",
                "personal": {
                    "dataset": {
                        "erpID": "",
                        "erpName": "",
                        "erpNumber": "",
                        "erpLastUpdate": "2018-03-16T12:03:34",
                        "erpCreation": "0000-01-01T00:00:00",
                        "pid": 19037,
                        "uid": 20000,
                        "alias": "",
                        "formOfAddress": "Herr",
                        "salutation": "",
                        "firstname": "Max",
                        "name1": "Mustermann",
                        "name2": "",
                        "title": "",
                        "custom1": "",
                        "custom2": "",
                        "birthday": "0000-01-01T00:00:00",
                        "lastUpdate": "0000-01-01T00:00:00"
                    },
                    "sys": {
                        "updated": "2018-08-13T04:25:14",
                        "message": "200 OK",
                        "code": 200
                    }
                }
            },
            "sys": {
                "updated": "2018-08-13T04:25:14",
                "message": "200 OK",
                "code": 200
            }
        }
    ],
    "sys": {
        "message": "200 OK",
        "code": 200
    }
}