Guide de l'uploader personnalisé de ShareX : liens de captures d'écran auto-hébergés

ShareX est un outil de capture d'écran gratuit et open source pour Windows qui réunit capture d'écran, enregistrement d'écran, partage de fichiers et outils de productivité.

La documentation de l'uploader personnalisé de ShareX, consultée en octobre 2026, décrit un système qui permet d'envoyer des images, du texte et des fichiers vers des services d'hébergement, ou de raccourcir et partager des URL. Ce guide suit cette documentation : comment fonctionne l'uploader personnalisé, comment en configurer un proprement, et comment protéger vos identifiants pendant que vous le faites.

Consultez la documentation de l'uploader personnalisé de ShareX.

Qu'est-ce qu'un uploader personnalisé réellement

Comme la documentation de ShareX elle-même le dit, la fonctionnalité d'uploader personnalisé est principalement utilisée par les personnes qui hébergent leurs propres services. En pratique, c'est une petite définition qui dit à ShareX : quand j'attrape quelque chose, envoie-le à cette URL, utilisant cette demande, et trouvez le lien résultant en cette partie de la réponse. Obtenez ces trois choses correctes et ShareX télécharge tranquillement et copie une URL de travail chaque fois que vous vous faites couper.

La demande : méthodes et types de corps

ShareX's custom uploader prend en charge les méthodes HTTP standard — GET, POST, PUT, PATCH et DELETE. En règle générale de la documentation : si la demande ne porte que des paramètres et aucun corps, GET est préféré ; s'il envoie un fichier comme multipart/form-data, POST est le choix habituel.

Pour le corps de la demande, ShareX offre plusieurs types afin qu'il puisse correspondre à ce que votre endpoint attend :

• Pas de corps — paramètres uniquement.
• Données de formulaire (multipart/form-data) — le choix typique pour télécharger un fichier.
• Form URL encoded (application/x-www-form-urlencoded).
• JSON (application/json).
• XML (application/xml).
• Binaire — le fichier brut en tant que corps.

La documentation API de votre serveur vous indique quelle méthode et quel type de corps elle attend ; vous refléter simplement cela dans la définition ShareX.

Analyse de la réponse : où est le lien ?

Après l'envoi, votre point de terminaison répond — généralement avec JSON, XML ou texte brut — et vous devez dire à ShareX quel champ contient l'URL finale. ShareX vous propose ces façons de l'extraire :

• JSON utilisant la syntaxe JsonPath, par exemple {json:data.link} à lire data.link à partir d'une réponse JSON.
• XML utilisant XPath, par exemple {xml:/files/file[1]/url}.
• Regex pour la correspondance de modèles d'une réponse en texte brut.
• En-têtes de lire une URL renvoyée dans un en-tête de réponse.

Si l'envoi réussit mais que l'URL copiée par ShareX est vide ou mal formée, l'analyseur pointe peut-être sur le mauvais champ. Regardez la réponse brute que renvoie votre serveur et suivez le chemin exact jusqu'à la chaîne URL.

Étape par étape : une configuration propre

1. Lisez la documentation API de votre endpoint et noter la méthode, le type de corps, le nom du champ pour le fichier, tout en-tête d'authentification et l'emplacement exact de l'URL dans la réponse.
2. Sauvegardez d'abord vos paramètres ShareX actuels. Exportez votre configuration de destination existante afin que vous puissiez revenir en arrière si une modification se comporte mal.
3. Créez l'uploader personnalisé dans ShareX (Destinations → Paramètres d'uploader personnalisé). Définissez la méthode de demande, l'URL de destination, les en-têtes et le type de corps pour correspondre à votre point de terminaison.
4. Configurez l'analyseur de réponse en utilisant la bonne règle JsonPath, XPath, regex ou d'en-tête pour que ShareX renvoie l'URL correcte.
5. Testez avec une capture inoffensive — une image jetable — et confirmez que le lien renvoyé ouvre réellement le fichier.
6. Vérifiez le comportement de suppression/rétention si votre endpoint supporte la suppression, vous savez comment supprimer un téléchargement plus tard.
7. Définissez-le comme votre destination active seulement une fois qu'un lien de test réel fonctionne d'un bout à l'autre.

Partage et réutilisation des configs : fichiers .sxcu

Un uploader personnalisé fini peut être exporté en tant que .sxcu fichier. Un autre utilisateur peut l'importer en double-cliquant sur le fichier, et ShareX applique la configuration de destination automatiquement. Cela le rend facile de partager une configuration qui fonctionne sur vos propres machines ou avec une équipe — mais c'est aussi exactement où les secrets fuient, alors lisez la section suivante avant d'en envoyer un à quelqu'un.

Protégez vos secrets

Un uploader personnalisé contient souvent des clés API, des jetons ou des identifiants signés. Traitez un .sxcu fichier comme un mot de passe :

• Avant de partager une configuration, supprimez ou remplacez les véritables identifiants de connexion avec des espaces réservés. Un .sxcu vous publiez publiquement peut exposer une clé en direct.
• Préférez les jetons limités et révocables plutôt que les clés maîtres de longue durée, donc une fuite est contenue et facile à pivoter.
• Toujours télécharger sur HTTPS les identifiants de connexion et les fichiers ne sont pas envoyés en clair.
• Faites pivoter tout ce qui peut avoir été exposé — les captures d'écran et leurs configs se déplacent plus loin que vous ne l'attendiez.

Préférez une destination intégrée quand il en existe une

Si votre stockage est Amazon S3, Google Cloud Storage ou Cloudflare R2, suivez le guide de ShareX pour ce fournisseur plutôt que de construire une requête HTTP générique à la main. Le guide Amazon S3 de ShareX, par exemple, couvre le bucket, les clés d'accès et un domaine personnalisé facultatif. Gardez l'uploader HTTP personnalisé générique pour les points de terminaison qui n'ont pas de guide.

Maxisnap Studio peut aussi envoyer vers votre propre serveur

Maxisnap Studio, une mise à niveau unique, ajoute des backends de téléchargement personnalisé — SFTP, FTP, S3-compatible et HTTP — de sorte que vos captures Windows sont envoyées vers un stockage que vous contrôlez. Vous pouvez voir comment les options d'envoi de Maxisnap sont structurées sur le Téléversement SFTP et Téléversement S3 / R2 pages, ou lire le Aperçu de Maxisnap et ShareX.

Maxisnap n'est pas affilié à ShareX. Cette page décrit ShareX tel que son site officiel le présentait en octobre 2026 ; consultez le site officiel pour connaître ses fonctionnalités, ses tarifs et ses plateformes actuels. getsharex.com