ShareX Custom Uploader Gids: Zelfgehoste Schermafbeelding Links

ShareX is een gratis, opensource screenshottool voor Windows die het vastleggen en opnemen van het scherm, het delen van bestanden en productiviteitsgereedschap combineert.

De documentatie van ShareX over aangepaste uploaders, gelezen in oktober 2026, beschrijft een systeem waarmee je afbeeldingen, tekst en bestanden kunt uploaden naar hostingdiensten of URL's kunt inkorten en delen. Deze gids volgt die documentatie: hoe de aangepaste uploader werkt, hoe je er netjes een instelt en hoe je je inloggegevens veilig houdt terwijl je dat doet.

Lees de documentatie van ShareX over aangepaste uploaders.

Wat een aangepaste uploader werkelijk is

Zoals ShareX's eigen documentatie stelt, wordt de functie voor aangepaste uploader vooral gebruikt door mensen die hun eigen services hosten. In de praktijk is het een kleine definitie die ShareX zegt: wanneer ik iets vast leg, stuur het naar deze URL, met behulp van dit verzoek, en vind de resulterende link in dit deel van de response. Krijg die drie dingen goed en ShareX uploadt stilzwijgend en kopieert een werkende URL telkens wanneer je vast legt.

Het verzoek: methodes en lichaamstypen

ShareX's aangepaste uploader ondersteunt de standaard HTTP-methoden — GET, POST, PUT, PATCH en DELETE. Als vuistregel uit de documentatie: als het verzoek alleen parameters heeft en geen lichaam, GET is voorkeur; als het een bestand als verzonden multipart/form-data, POST is de gebruikelijke keuze.

Voor het verzoek-lichaam biedt ShareX verschillende typen zodat het kan aansluiten bij wat je eindpunt verwacht:

• Geen body — alleen parameters.
• Formuliergegevens (multipart/form-data) — de typische keuze voor het uploaden van een bestand.
• Formulier URL gecodeerd (application/x-www-form-urlencoded).
• JSON (application/json).
• XML (application/xml).
• Binair — het ruwe bestand als het lichaam.

Je server's API-documentatie vertelt je welke methode en lichaamstype het verwacht; je weerspiegelt eenvoudig dat in de ShareX-definitie.

De response parseren: waar is de link?

Na de upload geeft je eindpunt antwoord — meestal met JSON, XML of platte tekst — en je moet ShareX vertellen welk veld de uiteindelijke URL bevat. ShareX biedt je deze manieren om die eruit te halen:

• JSON JsonPath-syntaxis gebruiken, bijv. {json:data.link} te lezen data.link uit een JSON-response.
• XML met behulp van XPath, bijv. {xml:/files/file[1]/url}.
• Regex voor patroonwedstrijding een platte-tekst response.
• Headers om een URL te lezen die in een response-header wordt geretourneerd.

Slaagt de upload maar is de URL die ShareX kopieert leeg of onjuist, dan wijst de parser mogelijk naar het verkeerde veld. Bekijk het ruwe antwoord dat je server teruggeeft en zoek het exacte pad naar de URL-string.

Stap-voor-stap: een schone opzet

1. Lees je eindpunt's API-documenten en noteer de methode, het lichaamstype, de veldnaam voor het bestand, elke auth-header en de exacte locatie van de URL in de response.
2. Maak eerst een back-up van uw huidige ShareX-instellingen. Exporteer je bestaande bestemming-configuratie zodat je kan terugvallen als een wijziging misslaat.
3. Maak de aangepaste uploader in ShareX (Bestemmingen → Aangepaste uploader-instellingen). Stel de verzoek-methode, bestemming URL, headers en lichaamstype in zodat deze overeenkomt met je eindpunt.
4. Configureer de response-parser met behulp van de juiste JsonPath, XPath, regex of headerregel zodat ShareX de juiste URL teruggeeft.
5. Test met een ongevaarlijke vastlegging — een wegwerp-afbeelding — en bevestig dat de geretourneerde link werkelijk het bestand opent.
6. Verwijder/retentie gedrag controleren als je eindpunt verwijdering ondersteunt, zodat je weet hoe je een upload later kunt verwijderen.
7. Stel het in als je actieve bestemming alleen zodra een echte test-link end-to-end werkt.

Configs delen en hergebruiken: .sxcu-bestanden

Een afgewerkt aangepaste uploader kan worden geëxporteerd als een .sxcu bestand. Een ander gebruiker kan het importeren door het bestand dubbel te klikken, en ShareX past de bestemmingsconfiguratie automatisch toe. Dat maakt het gemakkelijk om een werkende opzet over je eigen machines of met een team te delen — maar het is ook precies waar geheimen lekken, dus lees de volgende sectie voordat je er een naar iemand stuurt.

Bescherm je geheimen

Een aangepaste uploader bevat vaak API-sleutels, tokens of ondertekende geloofsbrieven. Behandel een .sxcu bestand als wachtwoord:

• Voordat je een config deelt, verwijder of vervang echte geloofsbrieven met aanduidingen. Een .sxcu je post openbaar kan een live sleutel blootgesteld.
• Kies scoped, revocable-tokens meer dan lange-leven master-sleutels, dus een lek is ingeperkt en gemakkelijk te roteren.
• Altijd uploaden via HTTPS dus geloofsbrieven en bestanden worden niet in het duidelijk verzonden.
• Roteer alles wat mogelijk is blootgesteld — schermafbeeldingen en hun configs reizen verder dan je verwacht.

Kies een ingebouwde bestemming wanneer er één is

Is je opslag Amazon S3, Google Cloud Storage of Cloudflare R2, volg dan de gids van ShareX voor die aanbieder in plaats van met de hand een generiek HTTP-verzoek op te bouwen. De Amazon S3-gids van ShareX behandelt bijvoorbeeld de bucket, de toegangssleutels en een optioneel eigen domein. Bewaar de generieke aangepaste HTTP-uploader voor eindpunten waarvoor geen gids bestaat.

Maxisnap Studio kan ook uploaden naar je eigen server

Maxisnap Studio, een eenmalige upgrade, voegt aangepaste upload backends toe — SFTP, FTP, S3-compatibel en HTTP — zodat je Windows-opnamen worden geüpload naar opslag die je zelf beheert. Je kunt zien hoe de uploadopties van Maxisnap zijn opgebouwd op de SFTP-upload en S3-/R2-upload pagina's, of lees de bredere Maxisnap en ShareX overzicht.

Maxisnap is niet gelieerd aan ShareX. Deze pagina beschrijft ShareX zoals de officiële site het in oktober 2026 presenteerde; raadpleeg de officiële site voor actuele functies, prijzen en platforms. getsharex.com