Workflow importieren und erstellen

Ermöglicht das Hochladen einer .flow-Datei und deren Import als Workflow innerhalb einer Organisation.

Über diese Schnittstelle können Sie eine .flow-Datei hochladen und als Workflow innerhalb einer Organisation importieren. Nach erfolgreichem Import wird automatisch ein API Key erstellt, und die Versionsverwaltung ist standardmäßig deaktiviert.

Anfragemethode

POST

Anfrage-URL

https://api.${endpoint}/v1/org/workflow/import

Authentifizierung der Anfrage

Basic-Authentifizierung mit DevKey / DevSecret auf Kontoebene; das aufrufende Konto muss über die Berechtigung zum Erstellen von Workflow der Organisation verfügen.

Anfrage

Beispielanfrage

curl -X POST 'https://api.${endpoint}/v1/org/workflow/import' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -F 'file=@/path/to/workflow.flow' \ -F 'org_id=p-xxxx' \ -F 'custom_name=Imported Workflow' \ -F 'enable_api=true'

                      
                      curl -X POST 'https://api.${endpoint}/v1/org/workflow/import' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -F 'file=@/path/to/workflow.flow' \
  -F 'org_id=p-xxxx' \
  -F 'custom_name=Imported Workflow' \
  -F 'enable_api=true'

Dieser Codeblock im schwebenden Fenster

Anfrage-Header

Feld	Typ	Beschreibung
Authorization	Basic ${BASIC_TOKEN}	Basic Token als Base64-Kodierung von `DevKey:DevSecret`.
Content-Type	multipart/form-data	Formular für den Datei-Upload.

Anfrageparameter (Form Data)

Parameter	Typ	Beschreibung	required
file	File	`.flow`-Datei.	true
org_id	String	Organisations-ID.	true
custom_name	String	Benutzerdefinierter Workflow-Name nach dem Import.	false
enable_api	Boolean	Ob versucht wird, die API zu aktivieren; Standard `true`. Unterstützt der Tarif keine API, ist der Import dennoch erfolgreich und gibt `api_enabled=false` zurück.	false

Antwort

Beispielantwort

{ "code": 0, "message": "OK", "data": { "workflow_id": "workflow-xxxx", "name": "Imported Workflow", "api_key": "app-xxxx", "api_enabled": true, "version_manage_enabled": false, "warning": null } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "workflow_id": "workflow-xxxx",
    "name": "Imported Workflow",
    "api_key": "app-xxxx",
    "api_enabled": true,
    "version_manage_enabled": false,
    "warning": null
  }
}

Dieser Codeblock im schwebenden Fenster

Erfolgreiche Antwort

Feld	Typ	Beschreibung
workflow_id	String	ID des importierten Workflow.
name	String	Workflow-Name.
api_key	String	Automatisch erstellter API Key, wird nur einmal zurückgegeben.
api_enabled	Boolean	Ob die API aktiviert ist.
version_manage_enabled	Boolean	Ob die Versionsverwaltung zulässig ist; beim Import standardmäßig deaktiviert.
warning	String	Warnhinweis beim Import.

Fehlerantwort

Feld	Typ	Beschreibung
code	Integer	Fehlercode.
message	String	Fehlerdetails.

Statuscodes

Statuscode	Beschreibung
200	Erfolgreich
400	Ungültige Parameter
401	Nicht autorisiert
403	Unzureichende Berechtigungen
429	Zu viele Anfragen
500	Serverfehler