Beschreibung des Endpunkts
POST- /api/search/<type>
Aufruf
Der Aufruf ist ein POST-Call und nach dem Grundmuster aller API-Calls gestaltet. Nach den Basis-Daten kann das Anfragende System Filter-Optionen mit angeben.
- Search: Hier werden die Filter-Kriterien mit angegeben (wird im Folgenden genauer beschrieben)
- Ordner: Mit dieser Liste wird der Abfrage gesagt in welcher Reihenfolge die Ergebnisse geliefert werden sollen. Es ist dabei möglich mehrere Reihenfolgen anzugeben. So kann z.B. bei de rAbfrage von Aufträge zuerst nach Kunden-Nr. und dann nach Anlage-Datum sortiert werden.
- Limit: Dieser Wert gibt an, wie viele Ergebnisse abgefragt werden sollen.
- Offset: Offset gibt an ab welchem Wert das Limit beginnen soll. Kann dafür verwendet werden, wenn Daten blockweise abgefragt werden sollen.
{
"api_version": 1,
"systemno": 4711,
"operatorno": 789,
"systemtype": "POSMAN",
"processno": 125,
"datetime": "2019-01-22T15:20:50+0100",
"data": {
"search": [
{
"data": "20180731235959",
"alias": "",
"operator": "<",
"type": "OPERATOR",
"columnname": "datum"
},
...
],
"order": [
{
"columname": "kdnr",
"alias": "",
"direction": "asc"
},
...
],
"limit": "100",
"offset": "0"
}
}
Ausgabe
Innerhalb des Typen wird fest definiert welche Objekte immer als Array zurückgegeben werden und welche nicht.
Beim Typen SalesOrderWithPosition werden die AuftragsPositionen immer als Array übergeben, auch wenn dem Auftrag nur eine Position zugewiesen ist.