Load an URL

Reference documentation on loading URLs using Mindee client libraries.

This is reference documentation.

Code samples shown are only examples, and will not work as-is. You'll need to copy-paste and modify according to your requirements.

Looking for a quick TL;DR, or full code samples?

• Take a look at the Quick Start page.

• Ask our documentation AI to write code samples for you: You can also use the "ask" button at the top of any page in the documentation.

Overview

Overall, the steps to sending an URL are:

1. Load the URL, this does not download anything locally.

2. Optional: adjust the source file before sending.

3. Use the Mindee client instance to send the file.

Requirements

In most cases you'll be loading a source file for use in the Mindee Client, take a look at the Configure the Client section for more info.

However, you don't actually need the client initialized to use these features, only the client library installed.

All Accepted Files may be used, if they adhere to the File Limits.

In addition, the source URL must adhere to the following rules:

• Secured using TLS (HTTPS).

• Publicly available using only the URL, no authentication headers.

• Authentication may be provided in the URL as query parameters: username+password or token. For example, Amazon S3 signed URLs will work.

• Contents must be a binary file (raw bytes, not base64-encoded).

• File contents cannot be encrypted, PDFs must not be password protected.

• The Mindee server will not follow redirections (HTTP 3xx).

Load the URL

Python

Use the URLInputSource class.

from mindee import UrlInputSource

input_source = UrlInputSource(
    "https://example.com/file.ext"
)

Node.js

PHP

Ruby

Java

.NET

Send the URL

Now that your URL is ready, you'll want to send it to the Mindee servers for processing.

Head on over to the Send a File or URL section for details on the next step.