API-documentatie

API-sleutel aanvragen

Log in, ga naar Mijn account en open het tabblad API. Daar zie je je sleutel, met een knop Opnieuw genereren. Als je een sleutel opnieuw genereert, is de oude meteen ongeldig. Pas hem dus overal aan waar je hem gebruikt voordat je klikt.

Op dat tabblad staat ook een tweede, onafhankelijke sleutel voor alleen uploaden. Zie de tip hieronder en Forumplugins voor wanneer je die beter kunt gebruiken.

Authenticatie

Stuur je sleutel mee als header. Dat heeft de voorkeur, omdat querystrings vaak in toegangslogs, proxylogs en Referer-headers terechtkomen:

X-API-Key: YOUR_API_KEY

Een queryparameter ?key= werkt ook, voor compatibiliteit met oudere integraties en snelle losse curl-opdrachten. Als beide aanwezig zijn, wint de header.

?key=YOUR_API_KEY

Endpoints

Uploaden, weergeven en verwijderen gebruiken dezelfde authenticatie en limieten; grote bestanden kun je eerst in stukken versturen.

POST /api - Een bestand uploaden

Uploadt één bestand voor het geauthenticeerde account.

Toegestane typen: JPG, PNG, GIF, WEBP, AVIF, BMP, TIFF, HEIC of HEIF-afbeeldingen; MP4, WEBM of AVI-video (de exacte lijst kan in de loop van de tijd groeien). HEIC/HEIF en TIFF worden als WebP opgeslagen, video anders dan MP4/WebM wordt naar MP4 geconverteerd, en grotere JPEG/PNG-afbeeldingen worden kort na het uploaden naar WebP geconverteerd als ze daardoor merkbaar kleiner worden. Maximale grootte: 200MB; te grote of onleesbare bestanden worden geweigerd met een 422.

Antwoord - 200 OK:

{
  "type": "success",
  "msg": "success",
  "data": {
    "id": "aB3xY9qRz1",
    "type": "image",
    "path": "https://i.yourimageshare.com/aB3xY9qRz1.png",
    "src": "https://yourimageshare.com/ib/aB3xY9qRz1.png",
    "direct": "https://yourimageshare.com/ib/aB3xY9qRz1",
    "thumb": "https://i.yourimageshare.com/thumb-aB3xY9qRz1.webp",
    "width": 1920,
    "height": 1080,
    "size": 482113,
    "locked": false,
    "visibility": "unlisted",
    "title": null,
    "description": null,
    "expires_at": null,
    "duplicate": false,
    "delete_url": "https://yourimageshare.com/delete#iV3x...k9"
  }
}

POST /api/chunk - Grote bestanden

Eén verzoek kan maximaal 100MB bevatten. Voor grotere bestanden (tot 200MB), of om elk verzoek klein te houden bij een trage verbinding, stuur je het bestand in stukken van maximaal 5MB en rond je af met POST /api:

1. Kies een upload-id: 32 willekeurige hex-tekens.
2. Stuur voor elk stuk een POST /api/chunk (multipart/form-data) met upload_id, index (vanaf 0), total (aantal stukken) en de bytes in chunk. Het antwoord is {"type": "success", "chunk_size": 5242880}.
3. Stuur POST /api met upload_id en filename in plaats van uploads, plus eventuele andere uploadvelden. Het antwoord is het normale uploadantwoord.

Stukken van een upload die niet wordt afgerond, worden na 2 uur verwijderd. Alleen de afsluitende POST /api telt mee voor de uploadlimieten.

GET /api/{id} en PATCH /api/{id} - Eén upload

GET geeft een van je uploads terug met dezelfde velden als de lijst hieronder. PATCH wijzigt de visibility, title of description (formuliervelden of JSON; een lege titel of beschrijving wist die) en geeft de bijgewerkte upload terug. Beide vereisen de volledige API-sleutel; 404 als er geen zo'n upload op je account staat.

curl -X PATCH https://yourimageshare.com/api/aB3xY9qRz1 \
  -H "X-API-Key: YOUR_API_KEY" -d visibility=public -d title="Sunset"

POST /api/{id}/replace - Het bestand vervangen

Verwisselt het bestand achter een van je uploads en behoudt de id, de pagina en alle links. Elk toegestaan type werkt, ook een ander type (een afbeelding kan een video worden). Stuur het nieuwe bestand als uploads (of de upload_id van een bestand dat in stukken is verstuurd met POST /api/chunk); keep_original werkt zoals bij uploaden. Het nieuwe bestand krijgt dezelfde controles en conversies als een nieuwe upload, en de vorige versie wordt verwijderd. Vereist de volledige API-sleutel; 404 als er geen zo'n upload op je account staat, 409 als hij met een wachtwoord is beveiligd of een weergavelimiet heeft.

curl -X POST https://yourimageshare.com/api/aB3xY9qRz1/replace \
  -H "X-API-Key: YOUR_API_KEY" -F [email protected]

GET /api - Je uploads weergeven

Geeft een gepagineerde lijst van de uploads van het geauthenticeerde account (van elke bron: API, website of editor), nieuwste eerst, 50 per pagina.

Antwoord - 200 OK:

{
  "type": "success",
  "data": [
    {
      "id": "aB3xY9qRz1",
      "type": "image",
      "title": null,
      "path": "https://i.yourimageshare.com/aB3xY9qRz1.webp",
      "src": "https://yourimageshare.com/ib/aB3xY9qRz1.webp",
      "direct": "https://yourimageshare.com/ib/aB3xY9qRz1",
      "thumb": "https://i.yourimageshare.com/thumb-aB3xY9qRz1.webp",
      "width": 1920,
      "height": 1080,
      "size": 482113,
      "locked": false,
      "visibility": "unlisted",
      "description": null,
      "expires_at": null,
      "created_at": "2026-07-23T15:43:28+01:00"
    }
  ],
  "meta": { "current_page": 1, "last_page": 1, "total": 1 }
}

De velden betekenen hier hetzelfde als in het uploadantwoord hierboven (bij een upload met wachtwoordbeveiliging zijn path en thumb kortlevende ondertekende links). Er is nog geen apart endpoint om één upload op te zoeken, dus deze lijst is ook de manier om achteraf de id van een bestand te vinden.

DELETE /api/{id} - Een upload verwijderen

Verwijdert een van de uploads van het geauthenticeerde account definitief. Dit kan via de API niet ongedaan worden gemaakt. {id} is de waarde die als id wordt teruggegeven door de upload- of lijst-endpoints.

Antwoord - 200 OK:

{ "type": "success", "msg": "Deleted." }

404 als er geen upload met die id op je account staat (die was nooit van jou, of is al verwijderd).

Limieten

Elke API-sleutel heeft onafhankelijke quota per minuut en per dag, plus een ruimere dagelijkse limiet per IP-adres als vangnet tegen één IP dat meerdere sleutels afwisselt. Uploaden, weergeven en verwijderen delen dezelfde limieten.

Deze limieten kunnen veranderen. Elk antwoord bevat standaard rate-limit-headers:

X-RateLimit-Limit: 20
X-RateLimit-Remaining: 14

Zodra een limiet wordt overschreden, krijg je een 429 terug, met een Retry-After-header die aangeeft hoeveel seconden je moet wachten.

Foutmeldingen

Elke foutmelding heeft dezelfde vorm, ongeacht endpoint of oorzaak:

{ "type": "error", "errors": "A human-readable description of what went wrong." }

Clientbibliotheken

Officiële SDK's die de bovenstaande endpoints omhullen met getypeerde resultaten en bij API-fouten een uitzondering geven, zodat je geen ruwe HTTP hoeft af te handelen.

JavaScript / TypeScript

Geen afhankelijkheden, werkt in Node.js en browsers. Ook op JSR als @yourimageshare/yourimageshare - npx jsr add @yourimageshare/yourimageshare - dezelfde broncode, rechtstreeks als TypeScript gepubliceerd.

npm install yourimageshare

Python

Eén afhankelijkheid (requests), Python 3.8+.

pip install yourimageshare

PHP

Geen Composer-afhankelijkheden (gebruikt de eigen curl-extensie van PHP), PHP 7.4+. Broncode op GitHub.

composer require yourimageshare/yourimageshare-php

Go

Geen afhankelijkheden (alleen de standaardbibliotheek), Go 1.18+. Zie pkg.go.dev voor de volledige referentiedocumentatie.

go get github.com/yourimageshare/yourimageshare/go

Rust

Twee afhankelijkheden (ureq voor blokkerende HTTP - zonder async runtime - plus serde), Rust 1.70+. Broncode op GitHub.

cargo add yourimageshare

Ruby

Geen gem-afhankelijkheden (stdlib Net::HTTP + json), Ruby 2.7+. Broncode op GitHub.

gem install yourimageshare

.NET

Eén afhankelijkheid (System.Text.Json van Microsoft zelf), richt zich op netstandard2.0 en werkt dus zowel met .NET Framework als met modern .NET. Broncode op GitHub. Gebouwd en getest tegen deze live API; publicatie op NuGet volgt binnenkort.

dotnet add package YourImageShare

Dart / Flutter

Eén afhankelijkheid (http, het eigen pakket van het Dart-team), Dart 2.17+. Broncode op GitHub. Gebouwd en getest tegen deze live API; publicatie op pub.dev volgt binnenkort.

dart pub add yourimageshare

Elixir

Eén afhankelijkheid (Req), Elixir 1.14+. Geeft {:ok, result}| {:error, reason}-tuples terug - het directe equivalent van de foutafhandeling van deze API in elke andere SDK - plus bang-varianten die een uitzondering geven. Broncode op GitHub, documentatie op HexDocs.

{:yourimageshare, "~> 1.1"}

MCP-server

Voor AI-codeeragents (Claude Code, Cursor en andere MCP-compatibele tools): voeg een screenshot toe aan een bugmelding, een PR-beschrijving of een supportgesprek als echte link in plaats van een base64-blob of een handmatige uploadstap. Werkt op dezelfde manier met Claude Desktop en elke andere MCP-client. Start direct met npx, zonder installatiestap:

npx yourimageshare-mcp

Tools: upload_image (een lokaal bestand, inline inhoud of een link, tot 200MB, met optionele zichtbaarheid, titel en automatisch verwijderen), list_uploads, get_upload, update_upload en delete_upload.

Ook in het officiële MCP Registry (als io.github.yourimageshare/yourimageshare) en vermeld op Smithery en Glama, als je MCP-client via een van die kanalen installeert.

Nieuw met MCP? Lees hoe je Claude en ChatGPT via MCP met deze API verbindt voor een volledige installatiehandleiding.

Codevoorbeelden

curl

# Upload a file
curl "https://yourimageshare.com/api" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "uploads=@/path/to/photo.jpg"

# Upload from a link (files up to 200MB; one direct upload request stops at 100MB -
# bigger files go in pieces, see Large Files above)
curl "https://yourimageshare.com/api" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "url=https://example.com/video.mp4"

# Upload a file that auto-deletes after 1 hour
curl "https://yourimageshare.com/api" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "uploads=@/path/to/photo.jpg" \
  -F "expires_in=3600"

# List uploads
curl "https://yourimageshare.com/api" -H "X-API-Key: YOUR_API_KEY"

# Upload a file without a page of its own (file only) and give it a title
curl "https://yourimageshare.com/api" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "uploads=@/path/to/photo.jpg" \
  -F "visibility=private" \
  -F "title=Sunset"

# Look up one upload, then make it public
curl "https://yourimageshare.com/api/aB3xY9qRz1" -H "X-API-Key: YOUR_API_KEY"
curl -X PATCH "https://yourimageshare.com/api/aB3xY9qRz1" \
  -H "X-API-Key: YOUR_API_KEY" -d "visibility=public"

# Delete an upload
curl -X DELETE "https://yourimageshare.com/api/aB3xY9qRz1" -H "X-API-Key: YOUR_API_KEY"

JavaScript (fetch)

const API_KEY = 'YOUR_API_KEY';
const BASE = 'https://yourimageshare.com/api';

async function uploadFile(file) {
  const form = new FormData();
  form.append('uploads', file);

  const res = await fetch(BASE, {
    method: 'POST',
    headers: { 'X-API-Key': API_KEY },
    body: form,
  });
  const json = await res.json();
  if (json.type !== 'success') throw new Error(json.errors);
  return json.data;
}

async function listUploads(page = 1) {
  const res = await fetch(`${BASE}?page=${page}`, {
    headers: { 'X-API-Key': API_KEY },
  });
  return res.json();
}

async function deleteUpload(id) {
  const res = await fetch(`${BASE}/${id}`, {
    method: 'DELETE',
    headers: { 'X-API-Key': API_KEY },
  });
  return res.json();
}

Python (requests)

import requests

API_KEY = "YOUR_API_KEY"
BASE = "https://yourimageshare.com/api"

HEADERS = {"X-API-Key": API_KEY}

# Upload a file
with open("/path/to/photo.jpg", "rb") as f:
    res = requests.post(BASE, headers=HEADERS, files={"uploads": f})
res.raise_for_status()
upload = res.json()["data"]

# List uploads
res = requests.get(BASE, headers=HEADERS, params={"page": 1})
uploads = res.json()

# Delete an upload
res = requests.delete(f"{BASE}/{upload['id']}", headers=HEADERS)

PHP (curl)

<?php

$apiKey = 'YOUR_API_KEY';
$base = 'https://yourimageshare.com/api';

// Upload a file
$curl = curl_init($base);
curl_setopt_array($curl, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ["X-API-Key: $apiKey"],
    CURLOPT_POSTFIELDS => ['uploads' => new CURLFile('/path/to/photo.jpg')],
    CURLOPT_RETURNTRANSFER => true,
]);
$upload = json_decode(curl_exec($curl), true)['data'];
curl_close($curl);

// List uploads
$curl = curl_init("$base?page=1");
curl_setopt($curl, CURLOPT_HTTPHEADER, ["X-API-Key: $apiKey"]);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$uploads = json_decode(curl_exec($curl), true);
curl_close($curl);

Go (net/http)

De officiële Go-SDK hierboven doet dit voor je. Deze ruwe versie is er voor wie de afhankelijkheid liever niet toevoegt.

package main

import (
    "bytes"
    "encoding/json"
    "io"
    "mime/multipart"
    "net/http"
    "os"
)

const apiKey = "YOUR_API_KEY"
const base = "https://yourimageshare.com/api"

func uploadFile(path string) (map[string]any, error) {
    file, err := os.Open(path)
    if err != nil {
        return nil, err
    }
    defer file.Close()

    body := &bytes.Buffer{}
    writer := multipart.NewWriter(body)
    part, _ := writer.CreateFormFile("uploads", path)
    io.Copy(part, file)
    writer.Close()

    req, _ := http.NewRequest("POST", base, body)
    req.Header.Set("Content-Type", writer.FormDataContentType())
    req.Header.Set("X-API-Key", apiKey)

    res, err := http.DefaultClient.Do(req)
    if err != nil {
        return nil, err
    }
    defer res.Body.Close()

    var result map[string]any
    json.NewDecoder(res.Body).Decode(&result)
    return result, nil
}

Screenshot-tools

Een browserextensie plus kant-en-klare configuraties en scripts om screenshots rechtstreeks naar YourImageShare te sturen, zonder handmatig uploaden. Elk ervan uploadt via hetzelfde /api-endpoint dat hierboven is beschreven.

Browserextensie (Chrome & Firefox)

De extensie YourImageShare Capture voor Chrome en Firefox heeft geen scripts of configuratiebestanden nodig. Ze legt het zichtbare gedeelte vast, een met de muis geselecteerd gebied of een hele pagina met scrollen, opent een ingebouwde editor voor pijlen, tekst, blur/afdekken en andere annotaties, en downloadt het resultaat, kopieert het naar je klembord of publiceert het met één klik rechtstreeks naar YourImageShare. Publiceren gebruikt hetzelfde /api-endpoint dat hierboven is beschreven: voeg je API-sleutel één keer toe onder Instellingen van de extensie en elke publicatie daarna geeft direct een deelbare link terug. Werkt in desktop Chrome (en andere Chromium-browsers), desktop Firefox en Firefox voor Android.

YourImageShare Capture voor Firefox downloaden YourImageShare Capture voor Chrome downloaden

ShareX

Download de aangepaste uploader hieronder en ga in ShareX naar Destinations > Custom uploader settings > Import > from file, open het gedownloade .sxcu-bestand en vervang YOUR_API_KEY in het veld Headers door je echte sleutel. Stel hem in als bestemming voor afbeeldingen/bestanden en schermafbeeldingen worden automatisch geüpload.

YourImageShare.sxcu downloaden

Flameshot (Linux)

Een klein shellscript dat flameshot gui start, de opname uploadt en de link naar je klembord kopieert. Koppel het aan een sneltoets in je desktopomgeving in plaats van de standaardsneltoets van Flameshot.

yis-flameshot-upload.sh downloaden

# One-time setup
chmod +x yis-flameshot-upload.sh
export YIS_API_KEY="YOUR_API_KEY"   # or add to ~/.config/yourimageshare/api_key

# Then bind this to a hotkey instead of calling flameshot directly:
/path/to/yis-flameshot-upload.sh

Greenshot (Windows)

Een PowerShell-script voor de ingebouwde bestemming External command van Greenshot. Compatibel met de Windows PowerShell 5.1 die bij Windows wordt geleverd, zonder extra installatie.

yis-greenshot-upload.ps1 downloaden

# One-time setup
setx YIS_API_KEY "YOUR_API_KEY"

# In Greenshot: Preferences > Destinations > External command > Settings
#   Command:   powershell.exe
#   Arguments: -ExecutionPolicy Bypass -File "C:\path\to\yis-greenshot-upload.ps1" "%1"

Forumplugins

Voeg een echte knop "Afbeelding uploaden" toe naast de berichteditor van je forum. Elke plugin uploadt via hetzelfde /api-endpoint dat hierboven is beschreven en plaatst BBCode op de plek van je cursor, zonder apart tabblad en zonder handmatig kopiëren en plakken.

Forumuploads zijn standaard private: de afbeelding werkt in het bericht, maar YourImageShare geeft er geen eigen pagina aan (geen opmerkingen, emoji-reacties of advertenties). Elke plugin heeft een instelling om over te schakelen naar unlisted als je ook een pagina wilt voor iedereen met de link.

phpBB

Een echte extensie voor phpBB 3.2/3.3. Pak uit in ext/, schakel hem in onder Customise > Manage extensions en vervang dan YOUR_UPLOAD_ONLY_KEY in het template-eventbestand van de extensie door je echte sleutel voor alleen uploaden.

Downloaden voor phpBB

SMF (Simple Machines Forum)

Een echt SMF-pakket: installeer via Admin > Package Manager en vervang dan YOUR_UPLOAD_ONLY_KEY in Sources/yis_forumupload.php door je echte sleutel voor alleen uploaden.

Downloaden voor SMF

MyBB

Een echte plugin voor MyBB 1.8. Kopieer naar inc/plugins/, activeer onder Configuration > Plugins en vervang dan YOUR_UPLOAD_ONLY_KEY in het pluginbestand door je echte sleutel voor alleen uploaden.

Downloaden voor MyBB

FluxBB, PunBB & ZetaBoards

Deze hebben geen formeel pluginsysteem, dus het is een klein codefragment dat je rechtstreeks in je template (FluxBB/PunBB) of Admin CP (ZetaBoards) plakt. Volledige instructies om te kopiëren en plakken voor elk:

Instructies voor FluxBB Instructies voor PunBB Instructies voor ZetaBoards

WordPress-plugin

Verplaats je mediabibliotheek naar YourImageShare in plaats van naar de lokale schijf. Nieuwe afbeeldingen en video's gaan automatisch via hetzelfde /api-endpoint dat hierboven is beschreven, het lokale bestand (en elk gegenereerd thumbnailformaat) wordt verwijderd zodra de upload is bevestigd, en elke WordPress- bijlage-URL - de blokeditor, uitgelichte afbeeldingen, galerijen, REST API - verwijst naar het bestand op YourImageShare. Geen shortcode, geen andere werkwijze.

• Verplaats een bestaande mediabibliotheek in bulk op de achtergrond (of met wp yis offload --all), niet alleen nieuwe uploads
• Afbeeldingen en video's die al in berichten staan, blijven werken nadat hun lokale bestanden zijn verwijderd
• Thumbnails en srcset gebruiken onze thumbnail van 280px, zodat kleine afbeeldingsplekken geen bestanden op volledige grootte laden
• Bestanden tot 200MB, in stukken verstuurd zodat grote video's een gedeelde host nooit zwaar belasten
• Zet een verplaatst bestand op elk moment terug naar lokale opslag
• Een kolom in de mediabibliotheek toont wat is verplaatst en wat nog lokaal staat
• Verplaatste bestanden worden als private opgeslagen: ze laden overal waar je site ze gebruikt, maar krijgen geen eigen pagina op YourImageShare

Downloaden via WordPress.org De ZIP downloaden

In WordPress: Plugins > Add New, zoek naar YourImageShare Media Offload, en kies Install en Activate.

Van de blog