Multipart/form-data

multipart/form-data is a form-data type that works with body payload or file upload.

Upload a File

Module which uploads a file to the service works with data type buffer in mappable parameters and type multipart/form-data in communication.

Occurrence in a Module

File Input Dialog

Notice the file input dialog, where the user can either choose the module that has a file available or manually map the file's name and data on their own.

This works only if the buffer is correctly implemented in interface in preceding modules.

Mappable Parameters

[
	{
		"name": "file_name",
		"type": "text",
		"label": "Name",
		"required": true,
		"semantic": "file:name"
	},
	{
		"name": "file_data",
		"type": "buffer",
		"label": "Data",
		"required": true,
		"semantic": "file:data"
	}
]

Communication

{
    "url": "http://example.com",
    "body": {
        "file": {
            "value": "{{parameters.file_data}}",
            "options": {
                "filename": "{{parameters.file_name}}"
            }
        }
    },
    "type": "multipart/form-data",
    "method": "POST"
}

Notice that the type of the request is multipart/form-data.