API Referentie: Data

Dataset Endpoints

Datasets zijn groepen van samenhangende datatables die logisch bij elkaar horen.

Datasets ophalen

Haal alle datasets binnen een tenant op.

Endpoint: GET /tenant/{tenantId}/datasets

Parameters:

Naam	Type	Locatie	Verplicht	Omschrijving
tenantId	string	path	Ja	Het unieke ID van de tenant

Response:

[
	{
		"id": "f6a7b8c9-d0e1-2345-fab6-789012345678",
		"displayName": "Sales Data",
		"createdAt": "2024-01-20T08:00:00Z",
		"datatableCount": 3
	}
]

---

Dataset aanmaken

Maak een nieuwe dataset aan binnen een tenant.

Endpoint: POST /tenant/{tenantId}/datasets

Parameters:

Naam	Type	Locatie	Verplicht	Omschrijving
tenantId	string	path	Ja	Het unieke ID van de tenant

Request Body:

{
	"displayName": "My New Dataset",
	"treeNodeType": "Dataset",
	"treeParentId": null
}

Veld	Type	Verplicht	Omschrijving
displayName	string	Ja	Naam van de dataset
treeNodeType	string	Nee	Moet Dataset (standaard) of TreeGroup zijn
treeParentId	string	Nee	ID van de bovenliggende groep voor datasets

Response: Geeft het aangemaakte dataset object terug.

---

Dataset ophalen

Haal details op van een specifieke dataset.

Endpoint: GET /tenant/{tenantId}/datasets/{datasetId}

Parameters:

Naam	Type	Locatie	Verplicht	Omschrijving
tenantId	string	path	Ja	Het unieke ID van de tenant
datasetId	string	path	Ja	De unieke kenmerk van de dataset

Response:

{
	"id": "f6a7b8c9-d0e1-2345-fab6-789012345678",
	"displayName": "Sales Data",
	"createdAt": "2024-01-20T08:00:00Z",
	"datatables": [
		{
			"id": "a7b8c9d0-e1f2-3456-abc7-890123456789",
			"displayName": "Orders",
			"rowCount": 15000
		}
	]
}

---

Dataset verwijderen

Verwijder een dataset en alle gekoppelde datatables.

Endpoint: DELETE /tenant/{tenantId}/datasets/{datasetId}

Parameters:

Naam	Type	Locatie	Verplicht	Omschrijving
tenantId	string	path	Ja	Het unieke ID van de tenant
datasetId	string	path	Ja	De unieke kenmerk van de dataset

Response:

{
	"success": true
}

---

Datatable Endpoints

Datatables bevatten de echte gebeurtenislog-data die gebruikt wordt voor Process Mining.

Datatables ophalen

Haal alle datatables binnen een tenant op.

Endpoint: GET /tenant/{tenantId}/datatables

Parameters:

Naam	Type	Locatie	Verplicht	Omschrijving
tenantId	string	path	Ja	Het unieke ID van de tenant

Response:

[
	{
		"id": "a7b8c9d0-e1f2-3456-abc7-890123456789",
		"displayName": "Orders 2024",
		"datasetId": "f6a7b8c9-d0e1-2345-fab6-789012345678",
		"rowCount": 15000,
		"createdAt": "2024-01-25T10:00:00Z"
	}
]

---

Datatable aanmaken

Maak een nieuwe datatable aan binnen een bestaande dataset.

Endpoint: POST /tenant/{tenantId}/datasets/{datasetId}/datatables

Parameters:

Naam	Type	Locatie	Verplicht	Omschrijving
tenantId	string	path	Ja	Het unieke ID van de tenant
datasetId	string	path	Ja	De unieke kenmerk van de dataset

Request Body:

{
	"displayName": "Orders Q1 2024"
}

Veld	Type	Verplicht	Omschrijving
displayName	string	Ja	Naam van de datatable

Response: Geeft het aangemaakte datatable object terug.

---

Datatable ophalen

Haal details op van een specifieke datatable.

Endpoint: GET /tenant/{tenantId}/datatable/{datatableId}

Parameters:

Naam	Type	Locatie	Verplicht	Omschrijving
tenantId	string	path	Ja	Het unieke ID van de tenant
datatableId	string	path	Ja	De unieke kenmerk van de datatable

Response:

{
	"id": "a7b8c9d0-e1f2-3456-abc7-890123456789",
	"displayName": "Orders 2024",
	"datasetId": "f6a7b8c9-d0e1-2345-fab6-789012345678",
	"rowCount": 15000,
	"columns": [
		{"name": "case_id", "type": "string"},
		{"name": "activity", "type": "string"},
		{"name": "timestamp", "type": "datetime"}
	],
	"createdAt": "2024-01-25T10:00:00Z"
}

---

Presigned upload-URL ophalen

Haal een tijdelijke URL op om een bestand direct naar een datatable te uploaden.

Endpoint: GET /tenant/{tenantId}/datatable/{datatableId}/uploads/presignedurl

Parameters:

Naam	Type	Locatie	Verplicht	Omschrijving
tenantId	string	path	Ja	Het unieke ID van de tenant
datatableId	string	path	Ja	De unieke kenmerk van de datatable
datasetid	string	query	Ja	De unieke kenmerk van de dataset
filename	string	query	Ja	De naam van het te uploaden bestand
filesize	string	query	Ja	Grootte van het bestand in bytes
filelastmodified	string	query	Ja	TijdsTip waarop het bestand voor het laatst is aangepast
validforseconds	string	query	Nee	Geldigheid van de URL in seconden (standaard: 3600)

Response:

{
	"PreSignedUploadUrl": "https://s3.amazonaws.com/bucket/path?X-Amz-Algorithm=AWS4-HMAC-SHA256&..."
}

Gebruik: Gebruik de opgehaalde URL om via HTTP PUT een bestand te uploaden:

# Get the presigned URL with required parameters
URL=$(curl -s -H "X-API-Key: your-api-key" \
  "https://api.processmind.com/tenant/{tenantId}/datatable/{datatableId}/uploads/presignedurl?datasetId={datasetId}&fileName=data.csv&fileSize=1024&fileLastModified=1704067200000")

# Upload the file
curl -X PUT --upload-file "data.csv" -H "Content-Type: text/csv" "$URL"