Bu sayfada
> kaynaklar > belgeler > api > API referansı: Süreçler

API referansı: Süreçler

Bu uç noktalar kendi çalışma alanınızda kullanılır. Bir çalışma alanı oluşturup ilk API çağrınızı yapmak için ücretsiz denemeyi başlatın.

Süreçleri listeleyin

Uç nokta: GET /v1/tenant/{tenantId}/processes

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · read kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
limit integer query Hayır Döndürülecek en fazla öğe sayısı
offset integer query Hayır Atlanacak öğe sayısı

Yanıt (200):

Süreç listesi

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

Hatalar:

  • 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş

Süreç oluşturun (boş modelle)

Uç nokta: POST /v1/tenant/{tenantId}/processes

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · write kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid

İstek gövdesi:

{
	"displayName": "string",
	"treeParentId": "00000000-0000-0000-0000-000000000000",
	"treeNodeType": "Process"
}
Alan Tür Gerekli Açıklama
displayName string Evet Süreç ağacında gösterilen süreç adı
En fazla 128 karakter
treeParentId string Hayır Üst klasör kimliği (null = en üst düzey)
Biçim: uuid
treeNodeType Process | TreeGroup Hayır Süreç veya TreeGroup (klasör)
İzin verilen değerler: Process, TreeGroup
Varsayılan: Process

Yanıt (201):

Oluşturulan süreç

{
	"id": "00000000-0000-0000-0000-000000000000",
	"treeParentId": "00000000-0000-0000-0000-000000000000",
	"treeNodeType": "Process",
	"displayName": "string",
	"createdAt": "2024-03-15T16:30:00Z",
	"updatedAt": "2024-03-15T16:30:00Z",
	"designerModelId": "00000000-0000-0000-0000-000000000000"
}
Alan Tür Zorunlu Açıklama
id string Evet Biçim: uuid
treeParentId string Evet Biçim: uuid
treeNodeType Process | TreeGroup Evet İzin verilen değerler: Process, TreeGroup
Varsayılan: Process
displayName string Evet Varsayılan: New Process
En fazla 128 karakter
createdAt string Evet Biçim: date-time
updatedAt string Evet Biçim: date-time
designerModelId string Evet Biçim: uuid

Hatalar:

  • 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş
  • 500 Beklenmeyen sunucu hatası: istek güvenle yeniden denenebilir

Bir süreci alın

Uç nokta: GET /v1/tenant/{tenantId}/processes/{processId}

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · read kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid

Yanıt (200):

Süreç

{
	"id": "00000000-0000-0000-0000-000000000000",
	"treeParentId": "00000000-0000-0000-0000-000000000000",
	"treeNodeType": "Process",
	"displayName": "string",
	"createdAt": "2024-03-15T16:30:00Z",
	"updatedAt": "2024-03-15T16:30:00Z",
	"designerModelId": "00000000-0000-0000-0000-000000000000"
}
Alan Tür Zorunlu Açıklama
id string Evet Biçim: uuid
treeParentId string Evet Biçim: uuid
treeNodeType Process | TreeGroup Evet İzin verilen değerler: Process, TreeGroup
Varsayılan: Process
displayName string Evet Varsayılan: New Process
En fazla 128 karakter
createdAt string Evet Biçim: date-time
updatedAt string Evet Biçim: date-time
designerModelId string Evet Biçim: uuid

Hatalar:

  • 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş
  • 404 Kaynak bulunamadı

Bir süreci güncelleyin

Uç nokta: PUT /v1/tenant/{tenantId}/processes/{processId}

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · write kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid

İstek gövdesi:

{
	"displayName": "string",
	"treeParentId": "00000000-0000-0000-0000-000000000000"
}
Alan Tür Zorunlu Açıklama
displayName string Hayır Süreç ağacında görünen süreç adı
En fazla 128 karakter
treeParentId string Hayır Üst klasör kimliği (null = en üst düzey)
Biçim: uuid

Yanıt (200):

Güncellenen süreç

{
	"id": "00000000-0000-0000-0000-000000000000",
	"treeParentId": "00000000-0000-0000-0000-000000000000",
	"treeNodeType": "Process",
	"displayName": "string",
	"createdAt": "2024-03-15T16:30:00Z",
	"updatedAt": "2024-03-15T16:30:00Z",
	"designerModelId": "00000000-0000-0000-0000-000000000000"
}
Alan Tür Zorunlu Açıklama
id string Evet Biçim: uuid
treeParentId string Evet Biçim: uuid
treeNodeType Process | TreeGroup Evet İzin verilen değerler: Process, TreeGroup
Varsayılan: Process
displayName string Evet Varsayılan: New Process
En fazla 128 karakter
createdAt string Evet Biçim: date-time
updatedAt string Evet Biçim: date-time
designerModelId string Evet Biçim: uuid

Hatalar:

  • 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş
  • 404 Kaynak bulunamadı
  • 500 Beklenmeyen sunucu hatası: istek güvenle yeniden denenebilir

Bir süreci geçici olarak silin

Uç nokta: DELETE /v1/tenant/{tenantId}/processes/{processId}

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · write kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid

Yanıt (200):

Süreç silindi

{
	"success": true,
	"message": "string"
}
Alan Tür Zorunlu Açıklama
success boolean Evet
message string Evet

Hatalar:

  • 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş
  • 404 Kaynak bulunamadı

Süreç modelini BPMN 2.0 XML olarak dışa aktarın

Uç nokta: GET /v1/tenant/{tenantId}/processes/{processId}/bpmn

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · read kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid

Yanıt (200):

BPMN XML

{
	"bpmnXml": "string"
}
Alan Tür Zorunlu Açıklama
bpmnXml string Evet BPMN 2.0 XML

Hatalar:

  • 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş
  • 403 API anahtarında gerekli kapsam veya kuruluş erişimi yok, kiracı etkin değil ya da plan dosya türüne izin vermiyor
  • 404 Kaynak bulunamadı
  • 500 Beklenmeyen sunucu hatası: istek güvenle yeniden gönderilebilir

Süreç için BPMN 2.0 modeli içe aktarın (mevcut modelin yerine geçer)

Uç nokta: PUT /v1/tenant/{tenantId}/processes/{processId}/bpmn

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · write kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid

İstek gövdesi:

{
	"bpmnXml": "string"
}
Alan Tür Zorunlu Açıklama
bpmnXml string Evet BPMN 2.0 XML

Yanıt (200):

BPMN yüklendi

{
	"message": "string"
}
Alan Tür Zorunlu Açıklama
message string Evet

Hatalar:

  • 400 Hatalı istek: ör. geçersiz filtre ifadesi, modeli olmayan bir süreç, desteklenmeyen yükleme türü veya zorunlu bir alanın eksik olması
  • 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş
  • 404 Kaynak bulunamadı

Veri haritalamaları, veri tablolarını süreçlere bağlayarak Event Log verilerinizi süreç modeli üzerinde görselleştirmenizi ve analiz etmenizi sağlar.

Bir sürecin veri haritalamalarını listeleyin

Uç nokta: GET /v1/tenant/{tenantId}/processes/{processId}/mappings

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · read kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid
limit integer query Hayır Döndürülecek en fazla öğe sayısı
offset integer query Hayır Atlanacak öğe sayısı

Yanıt (200):

Haritalama listesi

[
	{
		"id": "00000000-0000-0000-0000-000000000000",
		"modelId": "00000000-0000-0000-0000-000000000000",
		"dataTableId": "00000000-0000-0000-0000-000000000000",
		"displayName": "string",
		"color": {
			"id": "data-1"
		},
		"showByDefault": true,
		"mappingRole": "primary",
		"sortOrder": 0
	}
]

Hatalar:

  • 400 Hatalı istek: ör. geçersiz filtre ifadesi, modeli olmayan bir süreç, desteklenmeyen yükleme türü veya zorunlu bir alanın eksik olması
  • 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş
  • 404 Kaynak bulunamadı

Bir veri tablosunu sürece eşleyin (Event Log işlenmeye başlar)

Uç nokta: POST /v1/tenant/{tenantId}/processes/{processId}/mappings

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · write kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid

İstek gövdesi:

{
	"dataTableId": "00000000-0000-0000-0000-000000000000",
	"displayName": "string",
	"color": {
		"id": "data-1"
	},
	"showByDefault": true,
	"mappingRole": "primary"
}
Alan Tür Zorunlu Açıklama
dataTableId string Evet Sürece eşlenecek veri tablosu
Biçim: uuid
displayName string Hayır Haritalama görünen adı
En fazla 128 karakter
color object Hayır Vurgu rengi
showByDefault boolean Hayır Bu haritalamayı süreç görünümünde varsayılan olarak göster
Varsayılan: true
mappingRole primary | comparison Hayır Eşlenen verinin modeldeki rolü
İzin verilen değerler: primary, comparison

Yanıt (201):

Haritalama oluşturuldu

{
	"id": "00000000-0000-0000-0000-000000000000",
	"modelId": "00000000-0000-0000-0000-000000000000",
	"dataTableId": "00000000-0000-0000-0000-000000000000",
	"displayName": "string",
	"color": {
		"id": "data-1"
	},
	"showByDefault": true,
	"mappingRole": "primary",
	"sortOrder": 0
}
Alan Tür Zorunlu Açıklama
id string Evet Biçim: uuid
modelId string Evet Biçim: uuid
dataTableId string Evet Biçim: uuid
displayName string Evet En fazla 128 karakter
color object Evet
showByDefault boolean Evet Varsayılan: true
mappingRole primary | comparison Evet İzin verilen değerler: primary, comparison
Varsayılan: comparison
sortOrder integer Evet Varsayılan: 0
En az: -9007199254740991
En fazla: 9007199254740991

Hatalar:

  • 400 Hatalı istek: örneğin geçersiz filtre ifadesi, modeli olmayan bir süreç, desteklenmeyen yükleme türü veya eksik bir zorunlu alan
  • 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş
  • 403 API anahtarında gerekli kapsam veya kuruluş erişimi yok, kiracı etkin değil ya da plan dosya türüne izin vermiyor
  • 404 Kaynak bulunamadı

Bir haritalamayı güncelleyin

Uç nokta: PUT /v1/tenant/{tenantId}/processes/{processId}/mappings/{mappingId}

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · write kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid
mappingId string path Evet Biçim: uuid

İstek gövdesi:

{
	"displayName": "string",
	"color": {
		"id": "data-1"
	},
	"showByDefault": true,
	"mappingRole": "primary",
	"sortOrder": 0
}
Alan Tür Zorunlu Açıklama
displayName string Hayır En fazla 128 karakter
color object Hayır
showByDefault boolean Hayır
mappingRole primary | comparison Hayır İzin verilen değerler: primary, comparison
sortOrder integer Hayır En az: -9007199254740991
En fazla: 9007199254740991

Yanıt (200):

Haritalama güncellendi

{
	"id": "00000000-0000-0000-0000-000000000000",
	"modelId": "00000000-0000-0000-0000-000000000000",
	"dataTableId": "00000000-0000-0000-0000-000000000000",
	"displayName": "string",
	"color": {
		"id": "data-1"
	},
	"showByDefault": true,
	"mappingRole": "primary",
	"sortOrder": 0
}
Alan Tür Zorunlu Açıklama
id string Evet Biçim: uuid
modelId string Evet Biçim: uuid
dataTableId string Evet Biçim: uuid
displayName string Evet En fazla 128 karakter
color object Evet
showByDefault boolean Evet Varsayılan: true
mappingRole primary | comparison Evet İzin verilen değerler: primary, comparison
Varsayılan: comparison
sortOrder integer Evet Varsayılan: 0
En az: -9007199254740991
En fazla: 9007199254740991

Hatalar:

  • 400 Hatalı istek: ör. geçersiz filtre ifadesi, modeli olmayan bir süreç, desteklenmeyen yükleme türü veya zorunlu bir alanın eksik olması
  • 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş
  • 404 Kaynak bulunamadı

Bir haritalamayı silin

Uç nokta: DELETE /v1/tenant/{tenantId}/processes/{processId}/mappings/{mappingId}

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · write kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid
mappingId string path Evet Biçim: uuid

Yanıt (200):

Haritalama silindi

{
	"success": true,
	"message": "string"
}
Alan Tür Zorunlu Açıklama
success boolean Evet
message string Evet

Hatalar:

  • 400 Hatalı istek: ör. geçersiz filtre ifadesi, modeli olmayan bir süreç, desteklenmeyen yükleme türü veya zorunlu bir alanın eksik olması
  • 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş
  • 404 Kaynak bulunamadı

Bu uç noktalar, doğal dildeki açıklamalardan BPMN süreç modellerini otomatik olarak oluşturmak için yapay zekâ kullanır.

Doğal dildeki bir istemden süreç modeli oluşturun (asenkron; durum uç noktasını sorgulayın)

Uç nokta: POST /v1/tenant/{tenantId}/processes/{processId}/generate-model

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · write kapsamı · hız sınırı: saniyede 2 istek (ani artışta 4)

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid

İstek gövdesi:

{
	"prompt": "string"
}
Alan Tür Zorunlu Açıklama
prompt string Evet

Yanıt (200):

Oluşturma başladı / sonucu

{
	"message": "string"
}
Alan Tür Zorunlu Açıklama
message string Evet

Hatalar:

  • 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş
  • 404 Kaynak bulunamadı

Model oluşturma durumunu sorgulayın

Uç nokta: GET /v1/tenant/{tenantId}/processes/{processId}/generate-model/status

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · write kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid

Yanıt (200):

Oluşturma durumu

{
	"message": "string"
}
Alan Tür Zorunlu Açıklama
message string Evet

Hatalar:

  • 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş
  • 404 Kaynak bulunamadı

Sürecin en güncel modeline ait vaka bazındaki metrikler: hesaplanan akış ve sağlık metrikleriyle her vaka için bir satır.

Bir sürecin vaka bazındaki metriklerini alın (en güncel model, sayfalı)

Sürecin en güncel modeli için hesaplanan süreç metriklerini her vaka için bir satır olarak döndürür. Metrikler arasında vaka süresi, uzunluk, uygunluk, yeniden çalışma, sağlık skoru ve varyant gibi bilgiler yer alır. Satırlar filtrelenmez. Sonuç sayfalara bölünür: limit parametresini kullanın (varsayılan 1000, en fazla 10000) ve offset parametresini ayarlayın. hasMore değeri true olduğu sürece sonraki sayfaları almaya devam edin. Metrikler hesaplanırken yanıtın durumu preprocessing olur.

Uç nokta: GET /v1/tenant/{tenantId}/processes/{processId}/data/case-features

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · read kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid
limit integer query Hayır Döndürülecek en fazla vaka satırı sayısı (varsayılan 1000, en fazla 10000)
offset integer query Hayır Atlanacak vaka satırı sayısı (varsayılan 0)

Yanıt (200):

Vaka metrikleri

{
	"state": "ready",
	"processId": "00000000-0000-0000-0000-000000000000",
	"modelId": "00000000-0000-0000-0000-000000000000",
	"dataTableId": "00000000-0000-0000-0000-000000000000",
	"rowCount": 0,
	"hasMore": true,
	"rows": [
		{}
	]
}

Hatalar:

  • 400 Hatalı istek: ör. geçersiz filtre ifadesi, modeli olmayan bir süreç, desteklenmeyen yükleme türü veya zorunlu bir alanın eksik olması
  • 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş
  • 404 Kaynak bulunamadı
  • 503 Veri hattı hazır değil veya üst sistemdeki bir sorgu başarısız oldu

Süreç sürümlerini listeleyin

Uç nokta: GET /v1/tenant/{tenantId}/processes/{processId}/versions

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · read kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid
limit integer query Hayır Döndürülecek en fazla öğe sayısı
offset integer query Hayır Atlanacak öğe sayısı

Yanıt (200):

Sürüm listesi

[
	{
		"id": "00000000-0000-0000-0000-000000000000",
		"processId": "00000000-0000-0000-0000-000000000000",
		"modelId": "00000000-0000-0000-0000-000000000000",
		"versionNumber": 0,
		"versionType": "manual",
		"displayName": "string",
		"description": "string",
		"createdAt": "2024-03-15T16:30:00Z",
		"updatedAt": "2024-03-15T16:30:00Z",
		"processDisplayName": "string",
		"processShortDescription": "string",
		"publishedState": "draft",
		"elementCount": 0,
		"connectionCount": 0
	}
]

Hatalar:

  • 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş
  • 404 Kaynak bulunamadı

Sürecin sürüm anlık görüntüsünü oluşturun

Uç nokta: POST /v1/tenant/{tenantId}/processes/{processId}/versions

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · write kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid

İstek gövdesi:

{
	"displayName": "string",
	"description": "string",
	"versionType": "manual",
	"restoreFromVersionId": "00000000-0000-0000-0000-000000000000"
}
Alan Tür Gerekli Açıklama
displayName string Hayır Sürüm etiketi
Varsayılan: ""
En fazla 128 karakter
description string Hayır Sürüm için isteğe bağlı açıklama
versionType manual | auto Hayır manuel = kullanıcı tarafından oluşturuldu, auto = sistem tarafından oluşturuldu
İzin verilen değerler: manual, auto
restoreFromVersionId string Hayır Bu anlık görüntü oluşturulurken geri yüklenecek sürüm
Biçim: uuid

Yanıt (201):

Sürüm oluşturuldu

{
	"version": {
		"id": "00000000-0000-0000-0000-000000000000",
		"processId": "00000000-0000-0000-0000-000000000000",
		"modelId": "00000000-0000-0000-0000-000000000000",
		"versionNumber": 0,
		"versionType": "manual",
		"displayName": "string",
		"description": "string",
		"createdAt": "2024-03-15T16:30:00Z",
		"updatedAt": "2024-03-15T16:30:00Z",
		"processDisplayName": "string",
		"processShortDescription": "string",
		"publishedState": "draft",
		"elementCount": 0,
		"connectionCount": 0
	},
	"restoredFrom": {
		"id": "00000000-0000-0000-0000-000000000000",
		"processId": "00000000-0000-0000-0000-000000000000",
		"modelId": "00000000-0000-0000-0000-000000000000",
		"versionNumber": 0,
		"versionType": "manual",
		"displayName": "string",
		"description": "string",
		"createdAt": "2024-03-15T16:30:00Z",
		"updatedAt": "2024-03-15T16:30:00Z",
		"processDisplayName": "string",
		"processShortDescription": "string",
		"publishedState": "draft",
		"elementCount": 0,
		"connectionCount": 0
	}
}
Alan Tür Zorunlu Açıklama
version object Evet
restoredFrom object Evet

Hatalar:

  • 401 Eksik, geçersiz, devre dışı veya süresi dolmuş API anahtarı
  • 404 Kaynak bulunamadı

Süreç sürümünü alın

Uç nokta: GET /v1/tenant/{tenantId}/processes/{processId}/versions/{versionId}

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · read kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid
versionId string path Evet Biçim: uuid

Yanıt (200):

Sürüm

{
	"version": {
		"id": "00000000-0000-0000-0000-000000000000",
		"processId": "00000000-0000-0000-0000-000000000000",
		"modelId": "00000000-0000-0000-0000-000000000000",
		"versionNumber": 0,
		"versionType": "manual",
		"displayName": "string",
		"description": "string",
		"createdAt": "2024-03-15T16:30:00Z",
		"updatedAt": "2024-03-15T16:30:00Z",
		"processDisplayName": "string",
		"processShortDescription": "string",
		"publishedState": "draft",
		"elementCount": 0,
		"connectionCount": 0
	}
}
Alan Tür Zorunlu Açıklama
version object Evet

Hatalar:

  • 401 Eksik, geçersiz, devre dışı veya süresi dolmuş API anahtarı
  • 404 Kaynak bulunamadı

Süreç sürümünün adını değiştirin veya güncelleyin

Uç nokta: PUT /v1/tenant/{tenantId}/processes/{processId}/versions/{versionId}

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · write kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid
versionId string path Evet Biçim: uuid

İstek gövdesi:

{
	"displayName": "string",
	"description": "string"
}
Alan Tür Zorunlu Açıklama
displayName string Hayır Sürüm etiketi
Maksimum uzunluk: 128
description string Hayır Sürüm için isteğe bağlı açıklama

Yanıt (200):

Güncellenmiş sürüm

{
	"version": {
		"id": "00000000-0000-0000-0000-000000000000",
		"processId": "00000000-0000-0000-0000-000000000000",
		"modelId": "00000000-0000-0000-0000-000000000000",
		"versionNumber": 0,
		"versionType": "manual",
		"displayName": "string",
		"description": "string",
		"createdAt": "2024-03-15T16:30:00Z",
		"updatedAt": "2024-03-15T16:30:00Z",
		"processDisplayName": "string",
		"processShortDescription": "string",
		"publishedState": "draft",
		"elementCount": 0,
		"connectionCount": 0
	}
}
Alan Tür Zorunlu Açıklama
version object Evet

Hatalar:

  • 401 Eksik, geçersiz, devre dışı veya süresi dolmuş API anahtarı
  • 404 Kaynak bulunamadı

Süreç sürümünü silin

Uç nokta: DELETE /v1/tenant/{tenantId}/processes/{processId}/versions/{versionId}

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · write kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid
versionId string path Evet Biçim: uuid

Yanıt (200):

Sürüm silindi

{
	"deleted": true
}
Alan Tür Zorunlu Açıklama
deleted boolean Evet

Hatalar:

  • 401 Eksik, geçersiz, devre dışı veya süresi dolmuş API anahtarı
  • 404 Kaynak bulunamadı

Bir artefakt alın

Uç nokta: GET /v1/tenant/{tenantId}/artifacts/{artifactId}

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · read kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
artifactId string path Evet Biçim: uuid

Yanıt (200):

Artefakt

{
	"id": "00000000-0000-0000-0000-000000000000",
	"displayName": "string",
	"description": "string",
	"originalFileName": "string",
	"mimeType": "string",
	"kind": "Image",
	"artifactType": "modelIcon",
	"uploadState": "Uploading",
	"hasThumbnail": true,
	"sizeBytes": 0,
	"createdAt": "2024-03-15T16:30:00Z",
	"createdBy": "00000000-0000-0000-0000-000000000000"
}
Alan Tür Zorunlu Açıklama
id string Evet Biçim: uuid
displayName string Evet Varsayılan: ""
Maksimum uzunluk: 500
description string Evet Maksimum uzunluk: 2000
originalFileName string Evet Varsayılan: ""
Maksimum uzunluk: 500
mimeType string Evet Varsayılan: ""
Maksimum uzunluk: 200
kind Image | Pdf | Docx | Xlsx | Pptx | Text | Video Evet İzin verilen değerler: Image, Pdf, Docx, Xlsx, Pptx, Text, Video
artifactType modelIcon | processArtifact | doc | orgDoc | levelFrontPageImage Evet İzin verilen değerler: modelIcon, processArtifact, doc, orgDoc, levelFrontPageImage
Varsayılan: modelIcon
uploadState Uploading | Ready | Failed | Deleted Evet İzin verilen değerler: Uploading, Ready, Failed, Deleted
Varsayılan: Uploading
hasThumbnail boolean Evet Varsayılan: false
sizeBytes number Evet Varsayılan: 0
createdAt string Evet Biçim: date-time
createdBy string Hayır Biçim: uuid

Hatalar:

  • 401 Eksik, geçersiz, devre dışı veya süresi dolmuş API anahtarı
  • 404 Kaynak bulunamadı

Artefaktın görünen adını veya açıklamasını güncelleyin

Uç nokta: PUT /v1/tenant/{tenantId}/artifacts/{artifactId}

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · write kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
artifactId string path Evet Biçim: uuid

İstek gövdesi:

{
	"displayName": "string",
	"description": "string"
}
Alan Tür Zorunlu Açıklama
displayName string Hayır Artefakt adı
Maksimum uzunluk: 500
description string Hayır Artefakt için isteğe bağlı açıklama
Maksimum uzunluk: 2000

Yanıt (200):

Güncellenmiş artefakt

{
	"id": "00000000-0000-0000-0000-000000000000",
	"displayName": "string",
	"description": "string",
	"originalFileName": "string",
	"mimeType": "string",
	"kind": "Image",
	"artifactType": "modelIcon",
	"uploadState": "Uploading",
	"hasThumbnail": true,
	"sizeBytes": 0,
	"createdAt": "2024-03-15T16:30:00Z",
	"createdBy": "00000000-0000-0000-0000-000000000000"
}
Alan Tür Zorunlu Açıklama
id string Evet Biçim: uuid
displayName string Evet Varsayılan: ""
Maksimum uzunluk: 500
description string Evet Maksimum uzunluk: 2000
originalFileName string Evet Varsayılan: ""
Maksimum uzunluk: 500
mimeType string Evet Varsayılan: ""
Maksimum uzunluk: 200
kind Image | Pdf | Docx | Xlsx | Pptx | Text | Video Evet İzin verilen değerler: Image, Pdf, Docx, Xlsx, Pptx, Text, Video
artifactType modelIcon | processArtifact | doc | orgDoc | levelFrontPageImage Evet İzin verilen değerler: modelIcon, processArtifact, doc, orgDoc, levelFrontPageImage
Varsayılan: modelIcon
uploadState Uploading | Ready | Failed | Deleted Evet İzin verilen değerler: Uploading, Ready, Failed, Deleted
Varsayılan: Uploading
hasThumbnail boolean Evet Varsayılan: false
sizeBytes number Evet Varsayılan: 0
createdAt string Evet Biçim: date-time
createdBy string Hayır Biçim: uuid

Hatalar:

  • 401 Eksik, geçersiz, devre dışı veya süresi dolmuş API anahtarı
  • 404 Kaynak bulunamadı

Bir artefaktı silin

Uç nokta: DELETE /v1/tenant/{tenantId}/artifacts/{artifactId}

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · write kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
artifactId string path Evet Biçim: uuid

Yanıt (200):

Artefakt silindi

{
	"deleted": true
}
Alan Tür Zorunlu Açıklama
deleted boolean Evet

Hatalar:

  • 401 Eksik, geçersiz, devre dışı veya süresi dolmuş API anahtarı
  • 404 Kaynak bulunamadı

Artefaktı indirmek için imzalı URL’ye yönlendirin

Uç nokta: GET /v1/tenant/{tenantId}/artifacts/{artifactId}/open

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · read kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
artifactId string path Evet Biçim: uuid

Hatalar:

  • 302 İmzalı indirme URL’sine yönlendirme
  • 401 Eksik, geçersiz, devre dışı veya süresi dolmuş API anahtarı
  • 404 Kaynak bulunamadı

Bir sürece eklenmiş artefaktları listeleyin

Uç nokta: GET /v1/tenant/{tenantId}/processes/{processId}/artifacts

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · read kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid
limit integer query Hayır Döndürülecek en fazla öğe sayısı
offset integer query Hayır Atlanacak öğe sayısı

Yanıt (200):

Sürece ait artefaktların listesi

[
	{
		"id": "00000000-0000-0000-0000-000000000000",
		"artifactId": "00000000-0000-0000-0000-000000000000",
		"section": "string",
		"artifact": {
			"id": "00000000-0000-0000-0000-000000000000",
			"displayName": "string",
			"description": "string",
			"originalFileName": "string",
			"mimeType": "string",
			"kind": "Image",
			"artifactType": "modelIcon",
			"uploadState": "Uploading",
			"hasThumbnail": true,
			"sizeBytes": 0,
			"createdAt": "2024-03-15T16:30:00Z",
			"createdBy": "00000000-0000-0000-0000-000000000000"
		}
	}
]

Hatalar:

  • 401 Eksik, geçersiz, devre dışı veya süresi dolmuş API anahtarı
  • 404 Kaynak bulunamadı

Yeni bir süreç artefaktı için imzalı S3 yükleme URL’si alın

Uç nokta: POST /v1/tenant/{tenantId}/processes/{processId}/artifacts/uploads/presigned-url

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · write kapsamı

Parametreler:

Ad Tür Konum Zorunlu Açıklama
tenantId string path Evet Biçim: uuid
processId string path Evet Biçim: uuid

İstek gövdesi:

{
	"fileName": "string",
	"mimeType": "string",
	"sizeBytes": 0,
	"artifactType": "modelIcon"
}
Alan Tür Zorunlu Açıklama
fileName string Evet
mimeType string Evet
sizeBytes number Evet
artifactType modelIcon | processArtifact | doc | levelFrontPageImage Hayır İzin verilen değerler: modelIcon, processArtifact, doc, levelFrontPageImage
Varsayılan: processArtifact

Yanıt (200):

İmzalı yükleme URL’si

{
	"artifactId": "00000000-0000-0000-0000-000000000000",
	"originalUrl": "string",
	"thumbnailUrl": "string"
}
Alan Tür Zorunlu Açıklama
artifactId string Evet Biçim: uuid
originalUrl string Evet
thumbnailUrl string Evet

Hatalar:

  • 400 Hatalı istek: örneğin geçersiz bir filtre ifadesi, modeli olmayan bir süreç, desteklenmeyen bir yükleme türü veya eksik bir zorunlu alan
  • 401 Eksik, geçersiz, devre dışı veya süresi dolmuş API anahtarı
  • 403 API anahtarının gerekli kapsamı veya kuruluş erişimi yok, kiracı etkin değil ya da plan dosya türüne izin vermiyor
  • 404 Kaynak bulunamadı
  • 409 İstek mevcut durumla çakışıyor (ör. kullanıcı lisansı kısıtlaması veya yeniden kullanılan bir kimlik)

İlgili dokümantasyon

Süreçlerinizi daha iyi tasarlayın. Bağlantılı bir mimari kurun. Kontrolü elinizde tutun.

Kredi kartı gerekmeden, beklemeden hemen erişin. Kuruluşunuzdaki çalışma biçimini net ve birbiriyle bağlantılı süreç tasarımlarına dönüştürün.

Süreç mimarinizi oluşturun, sahiplik ve kontrolleri tanımlayın; rol ve sorumlulukları her düzeyde uyumlu hâle getirin.

Ücretsiz denemeyi başlatın; süreçlerinizi yönetmek ve sürekli iyileştirmek için güvenilir bir temel oluşturun.

Ücretsiz denemeyi başlatın