4. Setting Up Uploaders

This page explains how to configure HTTP and FTP uploaders in Custom Uploader, covering both simple and advanced form options. It’s designed to help you understand what each field does, how to fill them out, and how the app handles uploads to different destinations.

HTTP Uploader: Simple vs Advanced View

When creating an HTTP uploader, you can switch between:

Simple View

This mode is designed for ease of use. It includes only the most essential fields:

• Upload URL – Where the file should be sent (e.g., https://example.com/upload)
• Form Field Name – The key expected by the server for the file used to identify the file in the request body (e.g., file)
• Use File Encoding – Toggle to send file as encoded content

Tip

Ideal for public APIs or services with minimal configuration requirements.

Advanced View

Advanced View unlocks full control for power users, including:

• Upload URL
• Form Data Name
• Use File Encoding
• Headers - Add custom HTTP headers such as authentication tokens, content types, or any required key-value pairs.
  Example

Authorization: Bearer <token>
Content-Type: multipart/form-data

• Parameters - Query string parameters added to the URL.
  Example:

https://example.com/upload?token=mytoken&user=me

• Arguments – Key-value pairs sent in the request body alongside the file.
  

user_id = 42
album = "Vacation"

• Parse URL (optional) – Lets you extract the uploaded file's URL from the response using JSONPath, XMLPath, or Regex.
  Example (JSONPath):

{
  "data": {
    "link": "https://example.com/file.png"
  }
}

Syntax: $json:data.link$

XML Parsing Use XML path syntax.

Syntax: $xml:files/file[0]/url$

Regex Parsing Use regular expressions to match parts of the response.

• Use the ?? operator to handle multiple matches.
• Specify a match position using ??1, ??2, etc.

Syntax: $regex:https:\/\/example.com\/(.*)??1$

Tip

If you don’t provide a custom parsing rule, Custom Uploader will attempt to extract a URL automatically from the server response using a built-in regex.

• Parse Error Message (optional) – Extracts a readable error message from a failed response, using the same techniques.

FTP Uploader

• Server Address and Port
• Username / Password
• Remote Path (the folder where files will be stored)
• Once saved, FTP uploads will use these credentials and paths when sending files.

👉 Next: Learn how to view and manage logs for each upload attempt.