Skip to main content

API-documentatie

Upload afbeeldingen programmatisch met onze API

The ImageUpload.app API enables you to integrate image upload functionality into your web applications, mobile apps, or backend systems. With our RESTful API, you can upload images in seconds and integrate quickly using our JavaScript SDK. Create your API key and start using it right away!

Aan de slag

1. Haal uw API-sleutel op

Eerst moet u een account aanmaken en een API-token genereren via uw accountpagina.

2. API-verzoeken doen

Voeg uw API-sleutel op een van de volgende manieren toe:

  • Autorisatieheader: Authorization: Bearer YOUR_API_KEY
  • Aanvraagbody: key=YOUR_API_KEY
  • Queryparameter: ?key=YOUR_API_KEY

Afbeelding uploaden

POST https://imageupload.app/api/1/upload
Parameters
Parameter Type Vereist Beschrijving
key string Yes Uw API-sleutel
images file Yes Afbeeldingsbestand(en) om te uploaden (max. 15 bestanden, elk 32 MB)
Voorbeeldverzoek (cURL)
curl -X POST "https://imageupload.app/api/1/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "images=@/path/to/your/image.jpg"
Voorbeeldverzoek (JavaScript)
const formData = new FormData();
formData.append('images', fileInput.files[0]);
formData.append('key', 'YOUR_API_KEY');

fetch('https://imageupload.app/api/1/upload', {
  method: 'POST',
  body: formData
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
Antwoord (enkele afbeelding)
{
  "status": 200,
  "success": true,
  "data": {
    "id": "abc123def456",
    "title": "image.jpg",
    "url_viewer": "https://imageupload.app/i/abc123def456",
    "url": "https://i.imageupload.app/abc123def456.jpg",
    "display_url": "https://i.imageupload.app/abc123def456.jpg",
    "size": 102400,
    "time": 1698765432,
    "image": {
      "filename": "abc123def456.jpg",
      "name": "abc123def456",
      "mime": "image/jpeg",
      "extension": "jpg",
      "url": "https://i.imageupload.app/abc123def456.jpg"
    }
  }
}
Antwoord (meerdere afbeeldingen)
{
  "status": 200,
  "success": true,
  "data": {
    "images": [
      {
        "id": "abc123def456",
        "url": "https://i.imageupload.app/abc123def456.jpg",
        ...
      },
      {
        "id": "xyz789uvw012",
        "url": "https://i.imageupload.app/xyz789uvw012.jpg",
        ...
      }
    ],
    "count": 2
  }
}

Website Screenshot

POST https://imageupload.app/api/1/screenshot
Parameters
Parameter Type Vereist Beschrijving
key string Yes Uw API-sleutel
url string Yes The target website URL to capture.
preset string No Viewport preset identifier (e.g., desktop-1080p, iphone-14-pro, ipad-mini).
format string No png, jpeg (Default: png)
fullPage boolean No Set to true to capture the entire scrollable height of the webpage.
noAds boolean No Set to true to automatically hide common ad containers.
noCookie boolean No Set to true to automatically hide common cookie banner overlays.
colorScheme string No default, light, dark
zoom number No 0.5, 0.75, 1.0, 1.25, 1.5, 2.0
share boolean No Set to false to bypass host saving and receive a base64 encoded data URI instead.
Voorbeeldverzoek (cURL)
curl -X POST "https://imageupload.app/api/1/screenshot" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://google.com",
    "preset": "desktop-1080p",
    "fullPage": true
  }'
Antwoord (Gedeeld)
{
  "status": 200,
  "success": true,
  "data": {
    "id": "abc123def456",
    "url_viewer": "https://imageupload.app/i/abc123def456",
    "url": "https://i.imageupload.app/abc123def456.png",
    "display_url": "https://i.imageupload.app/abc123def456.png",
    "shared": true
  }
}
Antwoord (Privé/Base64)
{
  "status": 200,
  "success": true,
  "data": {
    "shared": false,
    "display_url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  }
}

JavaScript SDK

We bieden een eenvoudige JavaScript-bibliotheek voor eenvoudige integratie in uw website.

Installatie (CDN)
<script src="https://imageupload.app/imageupload-sdk.min.js"></script>
Installatie (npm)

To install our upload widget as an npm package for module bundlers (like Webpack, Vite, or Rollup): image-uploader-widget 

npm install image-uploader-widget
Basisgebruik
// Initialize the SDK
const uploader = new ImageUploadApp('YOUR_API_KEY');

// Upload a single file
uploader.upload(fileInput.files[0])
  .then(response => {
    console.log('Upload successful:', response.url);
  })
  .catch(error => {
    console.error('Upload failed:', error);
  });
Meerdere bestanden uploaden
const uploader = new ImageUploadApp('YOUR_API_KEY');

uploader.uploadMultiple(fileInput.files)
  .then(response => {
    console.log('Uploads successful:', response);
  })
  .catch(error => {
    console.error('Upload failed:', error);
  });
Uploadwidget maken
const uploader = new ImageUploadApp('YOUR_API_KEY');

uploader.createUploadWidget({
  multiple: true,
  onStart: (files) => {
    console.log('Starting upload:', files.length, 'files');
  },
  onProgress: (percent) => {
    console.log('Upload progress:', percent + '%');
  },
  onSuccess: (response, files) => {
    console.log('Upload successful:', response);
  },
  onError: (error, files) => {
    console.error('Upload failed:', error);
  }
});
Volledig voorbeeld
<!DOCTYPE html>
<html>
<head>
    <title>Image Upload Example</title>
    <script src="https://imageupload.app/imageupload-sdk.min.js"></script>
</head>
<body>
    <button id="uploadBtn">Upload Image</button>
    <div id="result"></div>

    <script>
        const uploader = new ImageUploadApp('YOUR_API_KEY');
        
        document.getElementById('uploadBtn').addEventListener('click', function() {
            uploader.createUploadWidget({
                multiple: false,
                onSuccess: (response) => {
                    document.getElementById('result').innerHTML = 
                        '<img src="' + response.url + '" style="max-width: 300px;">';
                },
                onError: (error) => {
                    alert('Upload failed: ' + error.message);
                }
            });
        });
    </script>
</body>
</html>

Foutcodes

Code Bericht Beschrijving
100 No API key provided API-sleutel ontbreekt in het verzoek
110 Invalid API key De opgegeven API-sleutel is niet geldig
120 User not found De gebruiker die aan de API-sleutel is gekoppeld, is niet gevonden
130 File size too large Bestand overschrijdt de maximale grootte van 32 MB
131 Too many files Maximaal 5 bestanden kunnen tegelijk worden geüpload
140 No image file provided Er is geen afbeeldingsbestand bij het verzoek gevoegd
150 No files could be uploaded Alle bestanden zijn niet geüpload

Why Use ImageUpload.app API?

🚀 Fast & Reliable

Your images are uploaded instantly with our high-performance servers and remain accessible at all times.

🔒 Secure

Your API keys are stored securely and all requests are encrypted over HTTPS.

📱 Easy Integration

Easily integrate into any platform with our RESTful API and JavaScript SDK. Getting started is easy with detailed documentation and examples!

Get Your API Key