Bu Sayfada

API Referansı: Veri

Dataset Uç Noktaları

Datasetler, ilişkili datatable’ların mantıksal olarak bir araya getirildiği koleksiyonlardır.

Verisetleri Listele

Tenant içindeki tüm datasetleri görüntüleyin.

Endpoint: GET /tenant/{tenantId}/datasets

Parametreler:

NameTypeLocationRequiredAçıklama
tenantIdstringpathEvetTenant’ın benzersiz kimliği

Yanıt:

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

Veriset Oluştur

Bir tenant içinde yeni bir dataset oluşturun.

Endpoint: POST /tenant/{tenantId}/datasets

Parametreler:

NameTypeLocationRequiredAçıklama
tenantIdstringpathEvetTenant’ın benzersiz kimliği

İstek Gövdesi:

{
	"displayName": "My New Dataset",
	"treeNodeType": "Dataset",
	"treeParentId": null
}
AlanTipZorunluAçıklama
displayNamestringEvetDataset adı
treeNodeTypestringHayırVarsayılan Dataset veya TreeGroup olmalı
treeParentIdstringHayırDatasetleri gruplamak için ana klasör ID’si

Yanıt: Oluşturulan dataset objesini döndürür.


Veriset Bilgilerini Getir

Belirli bir dataset hakkında detayları görüntüleyin.

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

Parametreler:

NameTypeLocationRequiredAçıklama
tenantIdstringpathEvetTenant’ın benzersiz kimliği
datasetIdstringpathEvetDataset’in benzersiz kimliği

Yanıt:

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

Veriset Sil

Bir dataset ve tüm datatable’larını silin.

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

Parametreler:

NameTypeLocationRequiredAçıklama
tenantIdstringpathEvetTenant’ın benzersiz kimliği
datasetIdstringpathEvetDataset’in benzersiz kimliği

Yanıt:

{
	"success": true
}

warning

Bir dataset silindiğinde, bağlantılı tüm datatable ve veriler kalıcı olarak silinir. Bu işlem geri alınamaz.


Datatable Uç Noktaları

Datatable’lar, Process Mining için kullanılan gerçek event log data’larını saklar.

Veritable’ları Listele

Tenant içindeki tüm datatable’ları görüntüleyin.

Endpoint: GET /tenant/{tenantId}/datatables

Parametreler:

NameTypeLocationRequiredAçıklama
tenantIdstringpathEvetTenant’ın benzersiz kimliği

Yanıt:

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

Veritable Oluştur

Mevcut bir dataset içinde yeni bir datatable oluşturun.

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

Parametreler:

NameTypeLocationRequiredAçıklama
tenantIdstringpathEvetTenant’ın benzersiz kimliği
datasetIdstringpathEvetDataset’in benzersiz kimliği

İstek Gövdesi:

{
	"displayName": "Orders Q1 2024"
}
AlanTipZorunluAçıklama
displayNamestringEvetDatatable adı

Yanıt: Oluşturulan datatable objesini döndürür.


Veritable Bilgilerini Getir

Belirli bir datatable hakkında detaylara erişin.

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

Parametreler:

NameTypeLocationRequiredAçıklama
tenantIdstringpathEvetTenant’ın benzersiz kimliği
datatableIdstringpathEvetDatatable’ın benzersiz kimliği

Yanıt:

{
	"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 Yükleme URL’si Al

Bir dosyayı doğrudan bir datatable’a yüklemek için geçici bir URL alın.

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

Parametreler:

NameTypeLocationRequiredAçıklama
tenantIdstringpathEvetTenant’ın benzersiz kimliği
datatableIdstringpathEvetDatatable’ın benzersiz kimliği
datasetidstringqueryEvetDataset’in benzersiz kimliği
filenamestringqueryEvetYüklenecek dosyanın adı
filesizestringqueryEvetDosya boyutu (byte)
filelastmodifiedstringqueryEvetDosyanın son değişiklik tarihi zaman damgası (zaman damgası)
validforsecondsstringqueryHayırURL’nin geçerlilik süresi (saniye olarak, varsayılan: 3600)

Yanıt:

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

Kullanım: Dönen URL ile dosyanızı HTTP PUT ile yükleyebilirsiniz:

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

info

Presigned URL’ler kısa süre geçerli olur. URL’yi aldıktan sonra hemen kullanın. Yükleme başarısız olursa yeni bir presigned URL alın.