เนื้อหาในหน้านี้

> ทรัพยากร > เอกสาร > api > เอกสารอ้างอิง API: ข้อมูล

เอกสารอ้างอิง API: ข้อมูล

warning

เมื่อลบ dataset ระบบจะลบ datatables และข้อมูลที่เกี่ยวข้องทั้งหมดอย่างถาวร และไม่สามารถย้อนกลับได้

วิธีใช้:

# Get the presigned URL with required parameters
URL=$(curl -s -H "X-API-Key: your-api-key" \
  "https://api.processmind.com/v1/tenant/{tenantId}/datatables/{datatableId}/uploads/presigned-url?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

URL ที่ลงนามไว้ล่วงหน้าจะหมดอายุภายในเวลาที่กำหนด โปรดใช้ URL ทันทีหลังจากได้รับ หากอัปโหลดไม่สำเร็จ ให้ขอ URL ที่ลงนามไว้ล่วงหน้าใหม่

วิธีใช้:

# Get the download URL
RESPONSE=$(curl -s -H "X-API-Key: your-api-key" \
  "https://api.processmind.com/v1/tenant/{tenantId}/datatables/{dataTableId}/download")

# Extract URL and download the file
DOWNLOAD_URL=$(echo $RESPONSE | jq -r '.downloadUrl')
curl -o "data.csv" "$DOWNLOAD_URL"

info

ระบบจะคงรูปแบบไฟล์ต้นฉบับของ datatables ที่อัปโหลดไว้ (CSV, Parquet, ORC, JSONL หรือ Excel) ส่วนผลการจำลองจะเป็นไฟล์ CSV เสมอ

วิธีใช้:

# Get delta presigned URL
RESPONSE=$(curl -s -H "X-API-Key: your-api-key" \
  "https://api.processmind.com/v1/tenant/{tenantId}/datatables/{dataTableId}/uploads/presigned-url?delta=true&filename=delta.csv&filesize=1024&filelastmodified=1704067200000")

# Upload the delta file
UPLOAD_URL=$(echo $RESPONSE | jq -r '.PreSignedUploadUrl')
curl -X PUT --upload-file "delta.csv" -H "Content-Type: text/csv" "$UPLOAD_URL"

info

ต้องโหลดข้อมูลเริ่มต้นลงใน datatable ก่อนจึงจะอัปโหลด delta ได้ ไฟล์ delta ต้องใช้รูปแบบเดียวกับไฟล์ต้นฉบับ (เช่น delta แบบ CSV สำหรับไฟล์ต้นฉบับ CSV หรือ delta แบบ Parquet สำหรับไฟล์ต้นฉบับ Parquet) และมีโครงสร้างคอลัมน์เหมือนกัน ไม่รองรับการอัปโหลด delta สำหรับไฟล์ Excel และ XES

info

หลังอัปโหลดผ่าน URL ที่ลงนามไว้ล่วงหน้าแล้ว ProcessMind จะประมวลผล delta และรวมเข้ากับข้อมูลต้นฉบับโดยอัตโนมัติ ตรวจสอบ GET /datatables/{dataTableId} จนกว่า hasDataLoaded จะเป็น true เพื่อดูว่าประมวลผลเสร็จแล้วหรือยัง

ชุดข้อมูลคือกลุ่มของตารางข้อมูลที่เกี่ยวข้องกันและจัดไว้ด้วยกันตามตรรกะ.

แสดงรายการ datasets

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

การยืนยันตัวตน: API key ที่จำกัดขอบเขตตาม tenant · ขอบเขตสิทธิ์ read

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: `uuid`
limit	integer	query	ไม่	จำนวนรายการสูงสุดที่ส่งคืน
offset	integer	query	ไม่	จำนวนรายการที่ข้าม

Response (200):

รายการ datasets

[
	{
		"id": "00000000-0000-0000-0000-000000000000",
		"treeParentId": "00000000-0000-0000-0000-000000000000",
		"treeNodeType": "Dataset",
		"displayName": "string",
		"createdAt": "2024-03-15T16:30:00Z",
		"updatedAt": "2024-03-15T16:30:00Z",
		"dataTableId": "00000000-0000-0000-0000-000000000000"
	}
]

ข้อผิดพลาด:

401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้ หรือหมดอายุ

สร้าง dataset (พร้อม datatable ว่าง)

Endpoint: POST /v1/tenant/{tenantId}/datasets

การยืนยันตัวตน: API key ที่จำกัดขอบเขตตาม tenant · ขอบเขตสิทธิ์ write

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: `uuid`

Request Body:

{
	"displayName": "string",
	"treeParentId": "00000000-0000-0000-0000-000000000000",
	"treeNodeType": "Dataset"
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
displayName	string	ใช่	ชื่อชุดข้อมูลที่แสดงในแผนผังข้อมูล ความยาวสูงสุด: 128
treeParentId	string	ไม่	ID โฟลเดอร์หลัก (null = ระดับบนสุด) รูปแบบ: `uuid`
treeNodeType	`Dataset` \| `TreeGroup`	ไม่	ชุดข้อมูลหรือโฟลเดอร์ ค่าที่ใช้ได้: `Dataset`, `TreeGroup` ค่าเริ่มต้น: `Dataset`

Response (201):

สร้าง dataset แล้ว

{
	"id": "00000000-0000-0000-0000-000000000000",
	"treeParentId": "00000000-0000-0000-0000-000000000000",
	"treeNodeType": "Dataset",
	"displayName": "string",
	"createdAt": "2024-03-15T16:30:00Z",
	"updatedAt": "2024-03-15T16:30:00Z",
	"dataTableId": "00000000-0000-0000-0000-000000000000"
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
id	string	ใช่	รูปแบบ: `uuid`
treeParentId	string	ใช่	รูปแบบ: `uuid`
treeNodeType	`Dataset` \| `TreeGroup`	ใช่	ค่าที่ใช้ได้: `Dataset`, `TreeGroup` ค่าเริ่มต้น: `Dataset`
displayName	string	ใช่	ค่าเริ่มต้น: `""` ความยาวสูงสุด: 128
createdAt	string	ใช่	รูปแบบ: `date-time`
updatedAt	string	ใช่	รูปแบบ: `date-time`
dataTableId	string	ใช่	รูปแบบ: `uuid`

ข้อผิดพลาด:

401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้ หรือหมดอายุ

ดู dataset

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

การยืนยันตัวตน: API key ที่จำกัดขอบเขตตาม tenant · ขอบเขตสิทธิ์ read

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: `uuid`
datasetId	string	path	ใช่	รูปแบบ: `uuid`

Response (200):

Dataset

{
	"id": "00000000-0000-0000-0000-000000000000",
	"treeParentId": "00000000-0000-0000-0000-000000000000",
	"treeNodeType": "Dataset",
	"displayName": "string",
	"createdAt": "2024-03-15T16:30:00Z",
	"updatedAt": "2024-03-15T16:30:00Z",
	"dataTableId": "00000000-0000-0000-0000-000000000000"
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
id	string	ใช่	รูปแบบ: `uuid`
treeParentId	string	ใช่	รูปแบบ: `uuid`
treeNodeType	`Dataset` \| `TreeGroup`	ใช่	ค่าที่ใช้ได้: `Dataset`, `TreeGroup` ค่าเริ่มต้น: `Dataset`
displayName	string	ใช่	ค่าเริ่มต้น: `""` ความยาวสูงสุด: 128
createdAt	string	ใช่	รูปแบบ: `date-time`
updatedAt	string	ใช่	รูปแบบ: `date-time`
dataTableId	string	ใช่	รูปแบบ: `uuid`

ข้อผิดพลาด:

401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้ หรือหมดอายุ
404 ไม่พบทรัพยากร

ลบ dataset แบบไม่ถาวร

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

การยืนยันตัวตน: API key ที่จำกัดขอบเขตตาม tenant · ขอบเขตสิทธิ์ write

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: `uuid`
datasetId	string	path	ใช่	รูปแบบ: `uuid`

Response (200):

ลบ dataset แล้ว

{
	"success": true,
	"message": "string"
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
success	boolean	ใช่
message	string	ใช่

ข้อผิดพลาด:

401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้ หรือหมดอายุ
404 ไม่พบทรัพยากร

แสดงรายการ datatables ใน dataset

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

การยืนยันตัวตน: API key ที่จำกัดขอบเขตตาม tenant · ขอบเขตสิทธิ์ read

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: `uuid`
datasetId	string	path	ใช่	รูปแบบ: `uuid`
limit	integer	query	ไม่	จำนวนรายการสูงสุดที่ส่งคืน
offset	integer	query	ไม่	จำนวนรายการที่ข้าม

Response (200):

รายการ datatables ใน dataset

[
	{
		"id": "00000000-0000-0000-0000-000000000000",
		"datasetId": "00000000-0000-0000-0000-000000000000",
		"displayName": "string",
		"createdAt": "2024-03-15T16:30:00Z",
		"updatedAt": "2024-03-15T16:30:00Z",
		"hasDataLoaded": true,
		"filterExpression": "string",
		"metaInfo": {
			"type": "nodata"
		}
	}
]

ข้อผิดพลาด:

401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้ หรือหมดอายุ
404 ไม่พบทรัพยากร

สร้าง datatable ว่างใน dataset

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

การยืนยันตัวตน: API key ที่จำกัดขอบเขตตาม tenant · ขอบเขตสิทธิ์ write

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: `uuid`
datasetId	string	path	ใช่	รูปแบบ: `uuid`

Request Body:

{
	"displayName": "string"
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
displayName	string	ใช่	ชื่อ datatable ความยาวสูงสุด: 128

Response (201):

สร้าง datatable แล้ว

{
	"id": "00000000-0000-0000-0000-000000000000",
	"datasetId": "00000000-0000-0000-0000-000000000000",
	"displayName": "string",
	"createdAt": "2024-03-15T16:30:00Z",
	"updatedAt": "2024-03-15T16:30:00Z",
	"hasDataLoaded": true,
	"filterExpression": "string",
	"metaInfo": {
		"type": "nodata"
	}
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
id	string	ใช่	รูปแบบ: `uuid`
datasetId	string	ใช่	รูปแบบ: `uuid`
displayName	string	ใช่	ค่าเริ่มต้น: `""` ความยาวสูงสุด: 128
createdAt	string	ใช่	รูปแบบ: `date-time`
updatedAt	string	ใช่	รูปแบบ: `date-time`
hasDataLoaded	boolean	ใช่	ค่าเริ่มต้น: `false`
filterExpression	string	ใช่	ความยาวสูงสุด: 4096
metaInfo	object \| object \| object \| object	ใช่

ข้อผิดพลาด:

401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้ หรือหมดอายุ
404 ไม่พบทรัพยากร

ตารางข้อมูลใช้จัดเก็บข้อมูลบันทึกเหตุการณ์จริงที่ใช้ใน process mining.

แสดงรายการ datatables

Endpoint: GET /v1/tenant/{tenantId}/datatables

การยืนยันตัวตน: API key ที่จำกัดขอบเขตตาม tenant · ขอบเขตสิทธิ์ read

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: `uuid`
limit	integer	query	ไม่	จำนวนรายการสูงสุดที่ส่งคืน
offset	integer	query	ไม่	จำนวนรายการที่ข้าม

Response (200):

รายการ datatables

[
	{
		"id": "00000000-0000-0000-0000-000000000000",
		"datasetId": "00000000-0000-0000-0000-000000000000",
		"displayName": "string",
		"createdAt": "2024-03-15T16:30:00Z",
		"updatedAt": "2024-03-15T16:30:00Z",
		"hasDataLoaded": true,
		"filterExpression": "string",
		"metaInfo": {
			"type": "nodata"
		}
	}
]

ข้อผิดพลาด:

401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้ หรือหมดอายุ

ดู datatable

Endpoint: GET /v1/tenant/{tenantId}/datatables/{dataTableId}

การยืนยันตัวตน: API key ที่จำกัดขอบเขตตาม tenant · ขอบเขตสิทธิ์ read

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: `uuid`
dataTableId	string	path	ใช่	รูปแบบ: `uuid`

Response (200):

Datatable

{
	"id": "00000000-0000-0000-0000-000000000000",
	"datasetId": "00000000-0000-0000-0000-000000000000",
	"displayName": "string",
	"createdAt": "2024-03-15T16:30:00Z",
	"updatedAt": "2024-03-15T16:30:00Z",
	"hasDataLoaded": true,
	"filterExpression": "string",
	"metaInfo": {
		"type": "nodata"
	}
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
id	string	ใช่	รูปแบบ: `uuid`
datasetId	string	ใช่	รูปแบบ: `uuid`
displayName	string	ใช่	ค่าเริ่มต้น: `""` ความยาวสูงสุด: 128
createdAt	string	ใช่	รูปแบบ: `date-time`
updatedAt	string	ใช่	รูปแบบ: `date-time`
hasDataLoaded	boolean	ใช่	ค่าเริ่มต้น: `false`
filterExpression	string	ใช่	ความยาวสูงสุด: 4096
metaInfo	object \| object \| object \| object	ใช่

ข้อผิดพลาด:

401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้ หรือหมดอายุ
404 ไม่พบทรัพยากร

อัปเดต datatable (displayName, parseSettings, …)

Endpoint: PUT /v1/tenant/{tenantId}/datatables/{dataTableId}

การยืนยันตัวตน: API key ที่จำกัดขอบเขตตาม tenant · ขอบเขตสิทธิ์ write

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: `uuid`
dataTableId	string	path	ใช่	รูปแบบ: `uuid`

Request Body:

{
	"displayName": "string",
	"filterExpression": "string"
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
displayName	string	ไม่	ชื่อ datatable ความยาวสูงสุด: 128
filterExpression	string	ไม่	นิพจน์ตัวกรองที่ใช้กับข้อมูล ความยาวสูงสุด: 4096

Response (200):

อัปเดต datatable แล้ว

{
	"id": "00000000-0000-0000-0000-000000000000",
	"datasetId": "00000000-0000-0000-0000-000000000000",
	"displayName": "string",
	"createdAt": "2024-03-15T16:30:00Z",
	"updatedAt": "2024-03-15T16:30:00Z",
	"hasDataLoaded": true,
	"filterExpression": "string",
	"metaInfo": {
		"type": "nodata"
	}
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
id	string	ใช่	รูปแบบ: `uuid`
datasetId	string	ใช่	รูปแบบ: `uuid`
displayName	string	ใช่	ค่าเริ่มต้น: `""` ความยาวสูงสุด: 128
createdAt	string	ใช่	รูปแบบ: `date-time`
updatedAt	string	ใช่	รูปแบบ: `date-time`
hasDataLoaded	boolean	ใช่	ค่าเริ่มต้น: `false`
filterExpression	string	ใช่	ความยาวสูงสุด: 4096
metaInfo	object \| object \| object \| object	ใช่

ข้อผิดพลาด:

401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้ หรือหมดอายุ
404 ไม่พบทรัพยากร

รับ URL ที่ลงนามไว้ล่วงหน้าเพื่อดาวน์โหลดไฟล์ต้นฉบับของ datatable

Endpoint: GET /v1/tenant/{tenantId}/datatables/{dataTableId}/download

การยืนยันตัวตน: API key ที่จำกัดขอบเขตตาม tenant · ขอบเขตสิทธิ์ read

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: `uuid`
dataTableId	string	path	ใช่	รูปแบบ: `uuid`

Response (200):

URL ดาวน์โหลด

{
	"downloadUrl": "string",
	"expiresInSeconds": 0
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
downloadUrl	string	ใช่
expiresInSeconds	number	ใช่

ข้อผิดพลาด:

400 คำขอไม่ถูกต้อง เช่น นิพจน์ตัวกรองไม่ถูกต้อง กระบวนการไม่มีโมเดล ประเภทไฟล์ที่อัปโหลดไม่รองรับ หรือไม่มีฟิลด์ที่จำเป็น
401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้ หรือหมดอายุ
404 ไม่พบทรัพยากร

ยกเลิกการอัปโหลดแบบ multipart และทิ้งส่วนที่อัปโหลดแล้ว

ต้องมีขอบเขตuploadDataในคีย์ API.

Endpoint: POST /v1/tenant/{tenantId}/datatables/{dataTableId}/uploads/multipart/abort

การยืนยันตัวตน: API key ที่จำกัดขอบเขตตาม tenant · ขอบเขตสิทธิ์ write

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: `uuid`
dataTableId	string	path	ใช่	รูปแบบ: `uuid`

Request Body:

{
	"uploadId": "string",
	"uploadHandle": "string"
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
uploadId	string	ใช่
uploadHandle	string	ใช่	ตัวระบุที่อ่านความหมายไม่ได้ ซึ่งส่งคืนในขั้นตอนเริ่มต้น

Response (200):

ยกเลิกแล้ว

{
	"message": "string"
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
message	string	ใช่

ข้อผิดพลาด:

401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้ หรือหมดอายุ
403 API key ไม่มีขอบเขตสิทธิ์หรือสิทธิ์เข้าถึงองค์กรตามที่กำหนด, tenant ไม่ได้เปิดใช้งาน หรือแพ็กเกจไม่รองรับประเภทไฟล์นี้
404 ไม่พบทรัพยากร

อัปโหลดแบบ multipart ให้เสร็จสมบูรณ์ (ขั้นตอนที่ 3 จาก 3)

ต้องมีขอบเขตuploadDataในคีย์ API ระบบจะประกอบส่วนที่อัปโหลดไว้ (โดยใช้ ETag) และเริ่มประมวลผลบันทึกเหตุการณ์.

Endpoint: POST /v1/tenant/{tenantId}/datatables/{dataTableId}/uploads/multipart/complete

การยืนยันตัวตน: API key ที่จำกัดขอบเขตตาม tenant · ขอบเขตสิทธิ์ write

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: `uuid`
dataTableId	string	path	ใช่	รูปแบบ: `uuid`

Request Body:

{
	"uploadId": "string",
	"uploadHandle": "string",
	"parts": [
		{
			"partNumber": 0,
			"eTag": "string"
		}
	]
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
uploadId	string	ใช่
uploadHandle	string	ใช่	ตัวระบุที่อ่านความหมายไม่ได้ ซึ่งส่งคืนในขั้นตอนเริ่มต้น
parts	object[]	ใช่

Response (200):

เสร็จสมบูรณ์ ({ completed: true })

{
	"message": "string"
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
message	string	ใช่

ข้อผิดพลาด:

401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้ หรือหมดอายุ
403 API key ไม่มีขอบเขตสิทธิ์หรือสิทธิ์เข้าถึงองค์กรตามที่กำหนด, tenant ไม่ได้เปิดใช้งาน หรือแพ็กเกจไม่รองรับประเภทไฟล์นี้
404 ไม่พบทรัพยากร

เริ่มอัปโหลด event log แบบ multipart (แบ่งเป็นส่วน) (ขั้นตอนที่ 1 จาก 3)

ต้องมีขอบเขตuploadDataในคีย์ API ระบบจะส่งuploadIdและuploadHandleแบบไม่เปิดเผยรายละเอียด เพื่อใช้กับคำขอparts, completeและabortถัดไป เหมาะสำหรับไฟล์ขนาดใหญ่.

Endpoint: POST /v1/tenant/{tenantId}/datatables/{dataTableId}/uploads/multipart/initiate

การยืนยันตัวตน: API key ที่จำกัดขอบเขตตาม tenant · ขอบเขตสิทธิ์ write

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: `uuid`
dataTableId	string	path	ใช่	รูปแบบ: `uuid`

Request Body:

{
	"fileName": "string",
	"fileSize": 0,
	"fileLastModified": 0,
	"partCount": 0,
	"delta": true,
	"datasetId": "00000000-0000-0000-0000-000000000000",
	"modelId": "00000000-0000-0000-0000-000000000000"
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
fileName	string	ใช่
fileSize	number	ใช่
fileLastModified	number	ใช่
partCount	number	ไม่	จำนวนส่วนที่ต้องเตรียม URL สำหรับ (ค่าเริ่มต้น 10)
delta	boolean	ไม่	ระบุว่าเป็นการอัปโหลด delta (แบบเพิ่มเฉพาะข้อมูลใหม่) หรือไม่
datasetId	string	ไม่	รูปแบบ: `uuid`
modelId	string	ไม่	รูปแบบ: `uuid`

Response (200):

เริ่มอัปโหลดแล้ว

{
	"uploadId": "string",
	"uploadHandle": "string",
	"partCount": 0,
	"partSizeBytes": 0
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
uploadId	string	ไม่
uploadHandle	string	ไม่	ตัวระบุที่อ่านความหมายไม่ได้ สำหรับขั้นตอนจัดการส่วนต่างๆ, ทำให้เสร็จสมบูรณ์ และยกเลิก
partCount	number	ไม่
partSizeBytes	number	ไม่

ข้อผิดพลาด:

401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้ หรือหมดอายุ
403 API key ไม่มีขอบเขตสิทธิ์หรือสิทธิ์เข้าถึงองค์กรตามที่กำหนด, tenant ไม่ได้เปิดใช้งาน หรือแพ็กเกจไม่รองรับประเภทไฟล์นี้
404 ไม่พบทรัพยากร

รับ URL ที่ลงนามไว้ล่วงหน้าสำหรับแต่ละส่วนของการอัปโหลดแบบ multipart (ขั้นตอนที่ 2 จาก 3)

ต้องมีขอบเขตuploadDataในคีย์ API ระบบจะส่ง URL PUT ที่ลงนามล่วงหน้าหนึ่งรายการต่อหมายเลขส่วนที่ร้องขอ.

Endpoint: POST /v1/tenant/{tenantId}/datatables/{dataTableId}/uploads/multipart/parts

การยืนยันตัวตน: API key ที่จำกัดขอบเขตตาม tenant · ขอบเขตสิทธิ์ write

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: `uuid`
dataTableId	string	path	ใช่	รูปแบบ: `uuid`

Request Body:

{
	"uploadId": "string",
	"uploadHandle": "string",
	"partNumbers": [
		0
	]
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
uploadId	string	ใช่
uploadHandle	string	ใช่	ตัวระบุที่อ่านความหมายไม่ได้ ซึ่งส่งคืนในขั้นตอนเริ่มต้น
partNumbers	number[]	ใช่

Response (200):

URL ที่ลงนามไว้ล่วงหน้าสำหรับแต่ละส่วน ({ uploadId, parts: [{ partNumber, url }] })

{
	"message": "string"
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
message	string	ใช่

ข้อผิดพลาด:

401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้ หรือหมดอายุ
403 API key ไม่มีขอบเขตสิทธิ์หรือสิทธิ์เข้าถึงองค์กรตามที่กำหนด, tenant ไม่ได้เปิดใช้งาน หรือแพ็กเกจไม่รองรับประเภทไฟล์นี้
404 ไม่พบทรัพยากร

รับ URL อัปโหลด S3 ที่ลงนามไว้ล่วงหน้าสำหรับข้อมูล event log (CSV/XLSX แบบเต็มหรือ delta)

ต้องมี scope uploadData ในคีย์ API (ไม่ขึ้นกับสิทธิ์อ่านหรือเขียน) ระบบจะตรวจสอบค่า filesize (ไบต์) กับขนาดอัปโหลดสูงสุดของแพลตฟอร์ม และตรวจสอบขนาดจริงของออบเจ็กต์อีกครั้งเมื่ออัปโหลดไฟล์เสร็จ.

Endpoint: GET /v1/tenant/{tenantId}/datatables/{dataTableId}/uploads/presigned-url

การยืนยันตัวตน: API key ที่จำกัดขอบเขตตาม tenant · ขอบเขตสิทธิ์ read

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: `uuid`
dataTableId	string	path	ใช่	รูปแบบ: `uuid`
filename	string	query	ใช่
filesize	string	query	ใช่	ขนาดไฟล์เป็นไบต์ (ตรวจสอบกับขนาดอัปโหลดสูงสุดของแพลตฟอร์ม)
filelastmodified	string	query	ใช่
datasetid	string	query	ไม่	จำเป็นสำหรับการอัปโหลดแบบเต็ม (ไม่ใช่ delta)
modelid	string	query	ไม่	รูปแบบ: `uuid`
delta	`true` \| `false`	query	ไม่	ค่าที่ใช้ได้: `true`, `false`
partnumber	string	query	ไม่
validforseconds	integer	query	ไม่	อายุของ URL ที่ลงนามไว้ล่วงหน้าเป็นวินาที (1–3600, ค่าเริ่มต้น 3600)

Response (200):

URL ที่ลงนามไว้ล่วงหน้า

{
	"PreSignedUploadUrl": "string"
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
PreSignedUploadUrl	string	ใช่	URL PUT ของ S3 ที่ลงนามไว้ล่วงหน้า (ใช้ได้ประมาณ 1 ชั่วโมง)

ข้อผิดพลาด:

401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้ หรือหมดอายุ
403 API key ไม่มีขอบเขตสิทธิ์หรือสิทธิ์เข้าถึงองค์กรตามที่กำหนด, tenant ไม่ได้เปิดใช้งาน หรือแพ็กเกจไม่รองรับประเภทไฟล์นี้
404 ไม่พบทรัพยากร
413ไฟล์มีขนาดเกินขีดจำกัดการอัปโหลดสูงสุดของแพลตฟอร์ม

เอกสารที่เกี่ยวข้อง

ข้อมูลอ้างอิง API: องค์กร

เอกสารอ้างอิง API สำหรับ endpoint การจัดการองค์กรและผู้ใช้.

เอกสารอ้างอิง API: tenant

เอกสารอ้างอิง API สำหรับ endpoint จัดการ tenant และควบคุมการเข้าถึงของผู้ใช้.

ข้อมูลอ้างอิง API: กระบวนการ

เอกสารอ้างอิง API สำหรับ endpoint การจัดการกระบวนการและการจับคู่ข้อมูล.

เอกสารอ้างอิง API: การจำลองกระบวนการ

เอกสารอ้างอิง API สำหรับ endpoint การจัดการการจำลองกระบวนการและการสร้างด้วย AI.

ออกแบบกระบวนการให้ดีขึ้น วางโครงสร้างที่เชื่อมโยงกัน และควบคุมได้.

เริ่มใช้งานได้ทันที ไม่ต้องใช้บัตรเครดิตและไม่ต้องรอ เปลี่ยนวิธีทำงานขององค์กรให้เป็นแบบจำลองกระบวนการที่ชัดเจนและเชื่อมโยงกัน.

สร้างสถาปัตยกรรมกระบวนการ กำหนดเจ้าของและการควบคุม พร้อมจัดบทบาทและความรับผิดชอบให้สอดคล้องกันในทุกระดับ.

เริ่มทดลองใช้ฟรี แล้วสร้างรากฐานที่เชื่อถือได้สำหรับกำกับดูแล จัดการ และปรับปรุงกระบวนการอย่างต่อเนื่อง.

เริ่มทดลองใช้ฟรีวันนี้