API Integration
Media File Explorer lets you send text, URLs, and files to custom HTTP endpoints directly from the app. This guide explains the feature and walks you through setting up your own server to receive shared content.
1. Overview
The API Integration feature allows you to define custom HTTP endpoints inside the app. When you share content, the app sends an HTTP POST request to your configured endpoint.
- Text / URL mode — sends the shared text or URL as a POST field
- File mode — uploads the file as a multipart form upload
- Custom headers — add any HTTP headers your server requires
- Basic Authentication — optional username / password support
- Additional fields — attach extra key-value pairs to every request
- Response handling — display the server response as a toast, alert, or copy it to the clipboard
2. Share Integration
Every API configuration you create appears in the Android share dialog. This means you can share text, URLs, or files from any app on your device directly to your configured endpoints — just like sharing to any other app.
3. Pro Feature
The free version of Media File Explorer includes one API configuration. Upgrade to Pro to create unlimited configurations and connect to as many endpoints as you need.
4. PHP Library
We provide an open-source PHP library that acts as a ready-made webhook receiver for Media File Explorer. It handles incoming requests, validates authentication, and can store files or forward content via email.
5. Server Setup
Follow these steps to set up the PHP library on your server.
5.1 Download
Download the latest release ZIP from the GitHub repository:
5.2 Upload to Your Server
Extract the ZIP and upload the contents to a directory on your web server. Make sure the directory is accessible via HTTPS. For example:
https://your-domain.com/share/
5.3 Configure share.php
Open share.php and edit the $config array to match your requirements:
$config = [
'email_enabled' => true,
'email_to' => 'you@example.com',
'email_subject' => 'New share from Media File Explorer',
'storage_enabled' => true,
'storage_dir' => __DIR__ . '/uploads/',
'auth_enabled' => true,
'auth_user' => 'your-username',
'auth_pass' => 'your-password',
'allowed_types' => ['image/jpeg', 'image/png', 'application/pdf'],
'max_file_size' => 10 * 1024 * 1024,
];5.4 Test the Endpoint
Verify your setup by sending a test request with curl:
curl -X POST https://your-domain.com/share/share.php \
-u your-username:your-password \
-F "text=Hello from Media File Explorer"6. App Configuration
Once your server is running, configure the app to point at your endpoint.
6.1 Text / URL Mode
- Open Media File Explorer and go to Settings > API Configurations
- Tap Add Configuration
- Enter a name (e.g. "My Server")
- Set the URL to your endpoint (e.g. https://your-domain.com/share/share.php)
- Set Mode to Text / URL
- Add any additional fields or headers your server expects
- Save the configuration
6.2 File Mode
- Create a new configuration or duplicate the one above
- Set Mode to File
- The file field name defaults to "file" — change it only if your server expects a different name
- Save the configuration
6.3 Authentication
If your server uses Basic Authentication, enable it in the configuration and enter your username and password. The app sends credentials via the standard HTTP Authorization header.
7. Response Handling
After a successful request the app can process the server response in several ways:
- Toast — show a brief notification with the response text
- Alert — display the response in a dialog
- Clipboard — copy the response text to the clipboard
- File — if the server returns a file, offer to save or open it
8. Need Help?
If you run into any issues or have questions about the API Integration feature, feel free to reach out: