Documentation API : Données

Endpoints Dataset

Un dataset regroupe plusieurs datatables liées logiquement.

Lister les Datasets

Affichez tous les donnéessets dans un tenant.

Endpoint : GET /tenant/{tenantId}/datasets

Paramètres :

Nom	Type	Emplacement	Obligatoire	Descriptionn
tenantId	string	path	Oui	Identifiant unique du tenant

Réponse :

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

---

Créer un Dataset

Créez un nouveau dataset dans un tenant.

Endpoint : POST /tenant/{tenantId}/datasets

Paramètres :

Nom	Type	Emplacement	Obligatoire	Descriptionn
tenantId	string	path	Oui	Identifiant unique du tenant

Corps de la requête :

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

Champ	Type	Obligatoire	Descriptionn
displayName	string	Oui	Nom du dataset
treeNodeType	string	Non	Doit être Dataset (par défaut) ou TreeGroup
treeParentId	string	Non	ID du dossier parent pour organiser vos donnéessets

Réponse : Retourne l’objet dataset créé.

---

Obtenir un Dataset

Consultez les détails d’un dataset spécifique.

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

Paramètres :

Nom	Type	Emplacement	Obligatoire	Descriptionn
tenantId	string	path	Oui	Identifiant unique du tenant
datasetId	string	path	Oui	Identifiant unique du dataset

Réponse :

{
	"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
		}
	]
}

---

Supprimer un Dataset

Supprimez un dataset et toutes ses datatables.

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

Paramètres :

Nom	Type	Emplacement	Obligatoire	Descriptionn
tenantId	string	path	Oui	Identifiant unique du tenant
datasetId	string	path	Oui	Identifiant unique du dataset

Réponse :

{
	"success": true
}

---

Endpoints Datatable

Les datatables stockent les données de logs d’événements utilisées pour le Process Mining.

Lister les Datatables

Affichez toutes les donnéestables dans un tenant.

Endpoint : GET /tenant/{tenantId}/datatables

Paramètres :

Nom	Type	Emplacement	Obligatoire	Descriptionn
tenantId	string	path	Oui	Identifiant unique du tenant

Réponse :

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

---

Créer une Datatable

Créez une nouvelle datatable dans un dataset existant.

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

Paramètres :

Nom	Type	Emplacement	Obligatoire	Descriptionn
tenantId	string	path	Oui	Identifiant unique du tenant
datasetId	string	path	Oui	Identifiant unique du dataset

Corps de la requête :

{
	"displayName": "Orders Q1 2024"
}

Champ	Type	Obligatoire	Descriptionn
displayName	string	Oui	Nom de les donnéestable

Réponse : Retourne l’objet datatable créé.

---

Obtenir une Datatable

Consultez les détails d’une datatable spécifique.

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

Paramètres :

Nom	Type	Emplacement	Obligatoire	Descriptionn
tenantId	string	path	Oui	Identifiant unique du tenant
datatableId	string	path	Oui	Identifiant unique de les donnéestable

Réponse :

{
	"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"
}

---

Obtenir une URL de téléversement pré-signée

Générez une URL temporaire pour téléverser un fichier dans une datatable.

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

Paramètres :

Nom	Type	Emplacement	Obligatoire	Descriptionn
tenantId	string	path	Oui	Identifiant unique du tenant
datatableId	string	path	Oui	Identifiant unique de les donnéestable
datasetid	string	query	Oui	Identifiant unique du dataset
filename	string	query	Oui	Nom du fichier à téléverser
filesize	string	query	Oui	Taille du fichier en octets
filelastmodified	string	query	Oui	Horodatage de la dernière modification du fichier
validforseconds	string	query	Non	Durée de validité de l’URL en secondes (par défaut : 3600)

Réponse :

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

Utilisation : Utilisez l’URL retournée pour téléverser un fichier avec HTTP PUT :

# 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"