Documentazione API

L'API di YourImageShare ti permette di caricare, elencare ed eliminare file via codice. È una piccola API JSON/REST: nessun SDK obbligatorio, bastano un client HTTP e una chiave API. Sono disponibili anche le librerie ufficiali JavaScript, Python e MCP.

Tutte le librerie client e gli strumenti qui sotto sono open source. Sfoglia il codice, segnala problemi o contribuisci sul nostro repository GitHub ufficiale: github.com/yourimageshare/yourimageshare.

Link di base: https://yourimageshare.com/api · Formato: JSON in entrata e in uscita, tranne i caricamenti che sono multipart/form-data · Autenticazione: una chiave API in ogni richiesta. · Specifica leggibile dalle macchine: /openapi.json (OpenAPI 3.1), per agenti e strumenti di generazione del codice che preferiscono non analizzare questa pagina.

Ottenere una chiave API

Accedi, vai su Il mio account e apri la scheda API. Lì trovi la tua chiave, insieme a un pulsante Rigenera. Rigenerare una chiave invalida subito quella vecchia, quindi aggiorna ovunque venga usata prima di cliccare.

Quella scheda contiene anche una seconda chiave solo caricamento indipendente: vedi il suggerimento qui sotto e i plugin per forum per sapere quando usarla.

Autenticazione

Invia la chiave in un header (metodo consigliato, perché le query string finiscono spesso nei log di accesso, nei log dei proxy e negli header Referer):

X-API-Key: YOUR_API_KEY

Funziona anche il parametro di query ?key=, mantenuto per compatibilità con le integrazioni più vecchie e per comandi curl veloci e occasionali. Se sono presenti entrambi, vince l'header.

?key=YOUR_API_KEY

Suggerimento: tratta la chiave come una password: chiunque la abbia può caricare, elencare, modificare ed eliminare file sul tuo account. Ogni richiesta riuscita viene registrata ed è visibile in un grafico nella scheda API della pagina del tuo account, suddivisa per giorno e per tipo di richiesta. Se una chiave deve stare in un posto che altri possono vedere (un plugin per forum, un file di configurazione pubblico), usa invece la chiave solo caricamento della stessa scheda: può solo caricare, mentre elencare, consultare, modificare ed eliminare i caricamenti la rifiutano con un errore 401.

Endpoint

Caricamento, elenco ed eliminazione condividono la stessa autenticazione e gli stessi limiti; i file grandi possono prima essere inviati a pezzi.

POST /api - Caricare un file

Carica un singolo file per l'account autenticato.

CampoTipoObbligatorioDescrizione
uploadsfileuno di questi treIl file da caricare, fino a 100MB (il limite per una singola richiesta attraverso la nostra rete). Un file per richiesta: questo endpoint non carica più file in blocco.
urlstringaUn link http(s) pubblico a un'immagine o a un video. Lo scarichiamo noi, quindi funzionano file fino a 200MB.
upload_idstringaUn file inviato prima a pezzi a POST /api/chunk, fino a 200MB.
filenamestringanoCon upload_id: il nome originale del file.
expires_ininteronoElimina automaticamente questo caricamento dopo tot secondi (da 60 a 31.536.000, cioè da 1 minuto a 1 anno). Omettilo per un caricamento normale e permanente.
allow_duplicatebooleanonoSalva una nuova copia anche se il tuo account ha già caricato esattamente lo stesso file (vedi duplicate sotto).
keep_originalbooleanonoMantiene l'immagine esattamente come caricata. Senza questa opzione, i file JPG/PNG sopra 1 MB vengono ottimizzati in WebP. I metadati come il GPS vengono rimossi in ogni caso.
visibilitystringanounlisted (predefinito): il file e la sua pagina funzionano per chiunque abbia il link, ma non sono elencati da nessuna parte. private: solo file; il link della pagina porta tutti, tranne te, direttamente al file (niente commenti, reazioni o pubblicità). public: elencato sul sito e indicizzabile.
titlestringanoFino a 90 caratteri, mostrato nella pagina del caricamento.
descriptionstringanoFino a 500 caratteri.

Tipi accettati: immagini JPG, PNG, GIF, WEBP, AVIF, BMP, TIFF, HEIC o HEIF; video MP4, WEBM, AVI, MOV, MKV, MPEG, WMV, FLV o 3GP (l'elenco esatto può ampliarsi nel tempo). HEIC/HEIF e TIFF vengono salvati come WebP, i video diversi da MP4/WebM vengono convertiti in MP4 e le immagini JPEG/PNG più grandi vengono convertite in WebP poco dopo il caricamento quando questo le rende sensibilmente più leggere. Dimensione massima: 200MB; i file troppo grandi o illeggibili vengono rifiutati con un errore 422.

Risposta - 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"
  }
}
CampoDescrizione
idL'identificatore univoco del file.
typeimage oppure video.
pathL'indirizzo di archiviazione del file così come caricato. Può cambiare poco dopo quando il file viene convertito (WebP/MP4), quindi salva src, non path.
srcLink diretto e permanente al file: apre sempre il file attuale, adatto per l'attributo src di <img>/<video> e per il salvataggio.
directLa pagina del file su YourImageShare (titolo, descrizione, commenti, opzioni di condivisione).
thumbUn'anteprima WebP larga 280px (per un video, il primo fotogramma), oppure null.
width, heightDimensioni di visualizzazione in pixel (in verticale; per un video, la dimensione del fotogramma), oppure null se non note.
sizeDimensione del file in byte così come salvato.
lockedtrue se il caricamento è protetto da password.
visibilityprivate, unlisted oppure public (vedi il campo della richiesta sopra).
title, descriptionCome impostati, oppure null. Il testo passa attraverso la stessa moderazione del sito.
delete_urlSolo per i nuovi caricamenti: un link privato che elimina questo caricamento senza chiave API. Mostrato una sola volta (viene salvato solo un hash): conservalo se ti serve.
expires_atData e ora ISO 8601 in cui questo caricamento verrà eliminato automaticamente, oppure null se non scade.
duplicatetrue se il tuo account aveva già caricato esattamente lo stesso file: viene restituito quel caricamento e non viene salvato nulla di nuovo. Non si applica ai caricamenti con scadenza né con allow_duplicate=1.

Caricamenti con scadenza: quando expires_at passa, il file viene eliminato dall'archivio e la pagina del caricamento inizia a restituire 410 Gone entro circa 5 minuti. Non si può annullare né prorogare a posteriori: elimina in anticipo con l'endpoint DELETE se devi rimuoverlo prima, oppure ricarica il file con un nuovo expires_in se deve durare di più.

POST /api/chunk - File grandi

Una singola richiesta può contenere al massimo 100MB. Per file più grandi (fino a 200MB), o per tenere piccola ogni richiesta con una connessione lenta, invia il file a pezzi di al massimo 5MB, poi concludi con POST /api:

  1. Scegli un id di caricamento: 32 caratteri esadecimali casuali.
  2. Per ogni pezzo, fai POST /api/chunk (multipart/form-data) con upload_id, index (da 0), total (numero di pezzi) e i byte in chunk. La risposta è {"type": "success", "chunk_size": 5242880}.
  3. Fai POST /api con upload_id e filename al posto di uploads, più gli altri campi di caricamento che vuoi. La risposta è la normale risposta di caricamento.

I pezzi di un caricamento non completato vengono eliminati dopo 2 ore. Solo il POST /api finale conta per i limiti di caricamento.

GET /api/{id} e PATCH /api/{id} - Un singolo caricamento

GET restituisce uno dei tuoi caricamenti con gli stessi campi dell'elenco qui sotto. PATCH cambia visibility, title o description (campi di modulo o JSON; un titolo o una descrizione vuoti li cancellano) e risponde con il caricamento aggiornato. Entrambi richiedono la chiave API completa; 404 se non esiste un caricamento del genere sul tuo account.

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 - Sostituire il file

Sostituisce il file di uno dei tuoi caricamenti mantenendone id, pagina e tutti i link. Funziona con qualsiasi tipo consentito, anche diverso (un'immagine può diventare un video). Invia il nuovo file come uploads (oppure upload_id di un file inviato a pezzi con POST /api/chunk); keep_original funziona come nel caricamento. Il nuovo file subisce gli stessi controlli e le stesse conversioni di un nuovo caricamento, e la versione precedente viene rimossa. Richiede la chiave API completa; 404 se non esiste un caricamento del genere sul tuo account, 409 se è protetto da password o con visualizzazioni limitate.

curl -X POST https://yourimageshare.com/api/aB3xY9qRz1/replace \
  -H "X-API-Key: YOUR_API_KEY" -F uploads=@new-version.png

GET /api - Elencare i tuoi caricamenti

Restituisce un elenco paginato dei caricamenti dell'account autenticato (da qualsiasi origine: API, sito o editor), dal più recente, 50 per pagina.

ParametroDoveObbligatorioDescrizione
pagequerynoNumero di pagina, per impostazione predefinita 1.

Risposta - 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 }
}

I campi hanno qui lo stesso significato che hanno nella risposta di caricamento sopra (per un caricamento protetto da password, path e thumb sono link firmati di breve durata). Per consultare un singolo caricamento tramite il suo id, usa GET /api/{id}.

DELETE /api/{id} - Eliminare un caricamento

Elimina definitivamente uno dei caricamenti dell'account autenticato. Non si può annullare dall'API. {id} è il valore restituito come id dagli endpoint di caricamento o di elenco.

Risposta - 200 OK:

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

404 se sul tuo account non esiste nessun caricamento con quell'id (o non è mai stato tuo, o è già stato eliminato).

POST /api/compare - Cursore prima/dopo

Crea un confronto prima/dopo di due tuoi caricamenti di immagini: una pagina con un cursore su /c/{id} che può essere incorporata anche in qualsiasi sito. Funziona anche la chiave solo caricamento. Invia before e after (id dei caricamenti, obbligatori) e, facoltativamente, title, label_before e label_after (per impostazione predefinita "Before" e "After").

Risposta - 201 Created:

{
  "type": "success",
  "id": "P7uAYy04VA",
  "url": "https://yourimageshare.com/c/P7uAYy04VA",
  "embed_url": "https://yourimageshare.com/embed/c/P7uAYy04VA",
  "embed": { "script": "<blockquote class=\"YISEmbed\" ...", "iframe": "<iframe ..." }
}

422 se uno dei due id non è un tuo caricamento di immagine (i video e le immagini protette da password non si possono usare).

Limiti di richieste

Ogni chiave API ha quote indipendenti al minuto e al giorno, più un tetto giornaliero per IP più ampio come protezione contro un singolo IP che cambia tra più chiavi. Caricamenti, elenchi ed eliminazioni condividono gli stessi limiti.

IntervalloLimite predefinitoAmbito
Al minuto20 richiesteper chiave API
Al giorno500 richiesteper chiave API completa
Al giorno2.000 richiesteper chiave solo caricamento (plugin che spostano intere librerie di media)
Al giorno2.000 richiesteper indirizzo IP
Al mese (UTC)3.000 caricamentiper account, tutte le sue chiavi insieme
Al minuto300 pezziper chiave API, solo POST /api/chunk

Quota mensile di caricamenti. Ogni account può caricare 3.000 file al mese tramite API, conteggiati su tutte le sue chiavi e sugli strumenti che le usano (SDK, plugin, estensioni del browser, MCP con chiave). Contano solo i caricamenti riusciti: elenchi, eliminazioni e richieste non riuscite no, e un file inviato a pezzi conta una sola volta. Il conteggio riparte il 1° di ogni mese (UTC). Puoi vedere il conteggio del mese in Il mio account > API. Oltre la quota, POST /api restituisce 429 con la data di azzeramento. La quota vale dal 1 gennaio 2027.

Questi limiti possono cambiare. Ogni risposta include gli header standard dei limiti di richieste:

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

Quando un limite viene superato, viene restituito un 429 con un header Retry-After che indica quanti secondi attendere.

Errori

Ogni risposta di errore ha la stessa struttura, indipendentemente dall'endpoint o dalla causa:

{ "type": "error", "errors": "A human-readable description of what went wrong." }
StatoSignificato
401Chiave API mancante o non valida.
403L'account o il tuo IP attuale è stato bloccato dai caricamenti.
404Nessun caricamento corrispondente a quell'id su questo account (consultazione, modifica, eliminazione).
413La richiesta supera i 100MB. Invia invece il file a pezzi (POST /api/chunk) o un link al file in url (fino a 200MB).
422Errore di validazione: nessun file o link fornito, tipo di file non supportato, dati dell'immagine illeggibili, dimensioni oltre il limite di 30000x30000px, file oltre 200MB, un upload_id non completato o scaduto, oppure un url che non è stato possibile scaricare (il messaggio ne spiega il motivo).
429Limite di richieste superato: vedi i limiti di richieste qui sopra.
500Qualcosa è andato storto in modo imprevisto lato server. Puoi riprovare senza problemi.

Librerie client

SDK ufficiali che racchiudono gli endpoint qui sopra con risultati tipizzati e sollevano errori sugli errori dell'API invece di dover gestire l'HTTP grezzo.

JavaScript / TypeScript

Zero dipendenze, funziona in Node.js e nei browser. Disponibile anche su JSR come @yourimageshare/yourimageshare - npx jsr add @yourimageshare/yourimageshare - stesso codice sorgente, pubblicato direttamente come TypeScript.

npm install yourimageshare

Python

Una dipendenza (requests), Python 3.8+.

pip install yourimageshare

PHP

Zero dipendenze Composer (usa l'estensione curl di PHP), PHP 7.4+. Codice sorgente su GitHub.

composer require yourimageshare/yourimageshare-php

Go

Zero dipendenze (solo libreria standard), Go 1.18+. Vedi pkg.go.dev per la documentazione di riferimento completa.

go get github.com/yourimageshare/yourimageshare/go

Rust

Due dipendenze (ureq per l'HTTP bloccante, senza runtime asincrono, più serde), Rust 1.70+. Codice sorgente su GitHub.

cargo add yourimageshare

Ruby

Zero dipendenze gem (Net::HTTP della libreria standard + json), Ruby 2.7+. Codice sorgente su GitHub.

gem install yourimageshare

.NET

Una dipendenza (System.Text.Json di Microsoft), destinato a netstandard2.0 quindi funziona sia con .NET Framework sia con il .NET moderno. Codice sorgente su GitHub. Sviluppato e verificato su questa API reale; pubblicazione su NuGet a breve.

dotnet add package YourImageShare

Dart / Flutter

Una dipendenza (http, il pacchetto ufficiale del team Dart), Dart 2.17+. Codice sorgente su GitHub. Sviluppato e verificato su questa API reale; pubblicazione su pub.dev a breve.

dart pub add yourimageshare

Elixir

Una dipendenza (Req), Elixir 1.14+. Restituisce tuple {:ok, result}| {:error, reason}, l'equivalente diretto della gestione degli errori di questa API in tutti gli altri SDK, più le varianti con punto esclamativo che sollevano eccezioni. Codice sorgente su GitHub, documentazione su HexDocs.

{:yourimageshare, "~> 1.1"}

Server MCP

Per gli agenti IA di programmazione (Claude Code, Cursor e altri strumenti compatibili con MCP): inserisci uno screenshot in una segnalazione di bug, nella descrizione di una PR o in una conversazione di supporto come link reale invece di un blob base64 o di un caricamento manuale. Funziona allo stesso modo con Claude Desktop e con qualsiasi altro client MCP.

Ospitato, niente da installare: aggiungilo come server MCP remoto (in Claude: Impostazioni › Connettori › Aggiungi connettore personalizzato; vale anche per ChatGPT, Cursor, VS Code e altri client che accettano il link di un server) con la tua chiave API nel link:

https://yourimageshare.com/mcp?key=YOUR_API_KEY

I client che permettono di impostare gli header possono usare https://yourimageshare.com/mcp con Authorization: Bearer YOUR_API_KEY. Il link con la tua chiave funziona come una password: tienilo privato e, se viene divulgato, ottieni una nuova chiave in Il mio account. Sul server ospitato, upload_image accetta un link pubblico (fino a 200MB) o contenuto base64 inline (fino a 15MB). Senza chiave, https://yourimageshare.com/mcp carica comunque in modo anonimo, come il sito: solo caricamenti non in elenco o privati, con limiti più bassi; il caricamento si elimina con il delete_url restituito. Gli altri strumenti richiedono una chiave.

In locale: eseguilo direttamente con npx, senza installazione (può anche leggere file dal tuo disco):

npx yourimageshare-mcp

Strumenti: upload_image (un file locale, contenuto inline o un link, fino a 200MB, con visibilità, titolo ed eliminazione automatica facoltativi), list_uploads, get_upload, update_upload e delete_upload.

Presente anche nel registro MCP ufficiale (come io.github.yourimageshare/yourimageshare) e in elenco su Glama, se il tuo client MCP si installa da uno di questi.

Non conosci MCP? Leggi come collegare Claude e ChatGPT a questa API tramite MCP per una guida completa alla configurazione.

Tutte e dieci hanno licenza MIT. Non c'è una libreria ufficiale per il tuo linguaggio? Gli esempi di codice qui sotto mostrano come chiamare direttamente l'API.

Esempi di codice

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)

L'SDK Go ufficiale qui sopra lo fa al posto tuo: questa versione grezza è per chi preferisce non aggiungere la dipendenza.

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
}

Strumenti per screenshot

Un'estensione per il browser più configurazioni e script pronti per inviare gli screenshot direttamente a YourImageShare, senza caricamento manuale. Ognuno carica tramite lo stesso endpoint /api descritto qui sopra.

Estensione per il browser (Chrome & Firefox)

L'estensione YourImageShare Capture per Chrome e Firefox fa a meno di script e file di configurazione. Cattura l'area visibile, una porzione selezionata trascinando o un'intera pagina a scorrimento, apre un editor integrato per frecce, testo, sfocatura/oscuramento e altre annotazioni, poi scarica il risultato, lo copia negli appunti o lo pubblica direttamente su YourImageShare con un clic. La pubblicazione usa lo stesso endpoint /api descritto qui sopra: aggiungi la tua chiave API una sola volta nelle Impostazioni dell'estensione e ogni pubblicazione successiva restituisce subito un link condivisibile. Funziona su Chrome per computer (e altri browser Chromium), Firefox per computer e Firefox per Android.

Scarica YourImageShare Capture per Firefox Scarica YourImageShare Capture per Chrome

ShareX

Scarica l'uploader personalizzato qui sotto, poi in ShareX vai su Destinations > Custom uploader settings > Import > from file, apri il file .sxcu scaricato e sostituisci YOUR_API_KEY nel campo Headers con la tua chiave reale. Impostalo come destinazione per immagini/file e le catture vengono caricate automaticamente.

Scarica YourImageShare.sxcu

Eliminazione: il link "Delete" di ShareX per ogni caricamento apre la nostra pagina di eliminazione nel browser (il delete_url monouso del caricamento), così puoi rimuovere una cattura direttamente dalla cronologia di ShareX. Puoi anche eliminare i caricamenti da Il mio account. Hai scaricato la configurazione prima di ottobre 2026? Scaricala di nuovo per avere questa funzione.

Flameshot (Linux)

Un piccolo script shell che esegue flameshot gui, carica la cattura e copia il link negli appunti. Associalo a una scorciatoia da tastiera nel tuo ambiente desktop al posto di quella predefinita di Flameshot.

Scarica yis-flameshot-upload.sh

# 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)

Uno script PowerShell per la destinazione integrata External command di Greenshot. Compatibile con Windows PowerShell 5.1 incluso in Windows, senza installare nulla in più.

Scarica yis-greenshot-upload.ps1

# 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"

Plugin per forum

Aggiungi un vero pulsante "Carica immagine" accanto all'editor dei messaggi del tuo forum. Ognuno carica tramite lo stesso endpoint /api descritto qui sopra e inserisce il BBCode dove si trova il cursore: niente scheda separata, niente copia e incolla manuale.

Qui sotto usa la tua chiave solo caricamento, non la chiave API. Ogni plugin mostra la chiave nel sorgente della pagina di ogni visitatore, e la chiave solo caricamento (Il mio account > scheda API) può solo caricare: non può elencare né eliminare i tuoi caricamenti anche se qualcuno la copia dalla pagina.

I caricamenti dai forum sono privati per impostazione predefinita: l'immagine funziona nel messaggio, ma YourImageShare non le assegna una pagina propria (niente commenti, reazioni o pubblicità). Ogni plugin ha un'impostazione per passare a unlisted se vuoi anche una pagina per chiunque abbia il link.

phpBB

Una vera estensione per phpBB 3.2/3.3. Decomprimila in ext/, attivala da Customise > Manage extensions, poi sostituisci YOUR_UPLOAD_ONLY_KEY nel file degli eventi del template dell'estensione con la tua vera chiave solo caricamento.

Scarica per phpBB

SMF (Simple Machines Forum)

Un vero pacchetto SMF: installalo da Admin > Package Manager, poi sostituisci YOUR_UPLOAD_ONLY_KEY in Sources/yis_forumupload.php con la tua vera chiave solo caricamento.

Scarica per SMF

MyBB

Un vero plugin per MyBB 1.8. Copialo in inc/plugins/, attivalo da Configuration > Plugins, poi sostituisci YOUR_UPLOAD_ONLY_KEY nel file del plugin con la tua vera chiave solo caricamento.

Scarica per MyBB

FluxBB, PunBB & ZetaBoards

Questi non hanno un sistema di plugin formale, quindi si tratta di un piccolo frammento di codice da incollare direttamente nel template (FluxBB/PunBB) o nel pannello di amministrazione (ZetaBoards): istruzioni complete da copiare e incollare per ciascuno:

Istruzioni per FluxBB Istruzioni per PunBB Istruzioni per ZetaBoards

Plugin WordPress

Sposta la tua Libreria dei media su YourImageShare invece che sul disco locale. I nuovi caricamenti di immagini/video passano automaticamente dallo stesso endpoint /api descritto qui sopra, il file locale (e ogni dimensione di anteprima generata) viene eliminato una volta confermato il caricamento, e ogni link degli allegati di WordPress (editor a blocchi, immagini in evidenza, gallerie, REST API) punta al file ospitato su YourImageShare. Nessuno shortcode, nessun cambiamento nel tuo modo di lavorare.

  • Sposta in blocco una Libreria dei media esistente in background (o con wp yis offload --all), non solo i nuovi caricamenti
  • Immagini e video già inseriti negli articoli continuano a funzionare dopo la rimozione dei file locali
  • Anteprime e srcset usano la nostra anteprima da 280px, così gli spazi piccoli per le immagini non caricano file a dimensione piena
  • File fino a 200MB, inviati a pezzi così i video grandi non mettono mai in difficoltà un hosting condiviso
  • Ripristina in qualsiasi momento qualsiasi file spostato nell'archiviazione locale
  • Una colonna nella Libreria dei media mostra cosa è stato spostato e cosa è ancora locale
  • I file spostati vengono salvati come privati: si caricano ovunque il tuo sito li usi, ma non hanno una pagina propria su YourImageShare

Usa la tua chiave solo caricamento, non la chiave API. La chiave API completa, facoltativa, serve solo se vuoi che i file spostati vengano eliminati da YourImageShare quando li elimini in WordPress.

Scaricalo da WordPress.org Scarica lo ZIP

In WordPress: Plugin > Aggiungi nuovo, cerca YourImageShare Media Offload, poi Installa e Attiva.

Pulsante Carica per qualsiasi sito

Offri ai tuoi visitatori un pulsante "Carica" su qualsiasi sito: un modulo di commento, una pagina di assistenza, un forum per cui non abbiamo un plugin, un sito statico. Incolla due righe; niente account e nessun codice lato server.

<a class="yis-upload" href="https://yourimageshare.com/" data-target="#message" data-format="bbcode">Image and video hosting by YourImageShare</a>
<script src="https://yourimageshare.com/w.js" async></script>

Entrambi gli attributi sono facoltativi: senza di essi il pulsante mostra i link con un pulsante Copia. Il riquadro di caricamento è costruito attorno al link.

  • I caricamenti avvengono direttamente nella tua pagina: clicca il pulsante, trascina i file sopra o incolla uno screenshot al suo interno, anche più file insieme, con barra di avanzamento e anteprima
  • Anche le immagini incollate o trascinate direttamente nel campo indicato in data-target (qualsiasi textarea, input o riquadro modificabile) vengono caricate e i link vengono aggiunti a quel campo; senza un target compaiono sotto il pulsante con un pulsante Copia
  • data-format: url (link diretto al file, il predefinito), page, bbcode, html o markdown; data-label cambia il testo del pulsante
  • data-key (facoltativo): la tua chiave solo caricamento (Il mio account > API). I caricamenti finiscono allora nel tuo account con i tuoi limiti. Senza chiave, i caricamenti sono anonimi e non in elenco, con un limite giornaliero per visitatore e per sito
  • Gli sviluppatori possono ascoltare l'evento yis:upload sul riquadro di caricamento: event.detail.item contiene {id, type, page, url, thumb}
  • File fino a 95 MB tramite il pulsante (quelli più grandi sul sito). Si applicano come di consueto la nostra moderazione e i nostri termini; ogni visitatore ha il proprio link di eliminazione

Il pulsante è disegnato in un riquadro isolato, così il CSS del tuo sito non può rovinarlo. Il piccolo link "Image and video hosting by YourImageShare" resta visibile dentro il riquadro di caricamento.

Comando rapido per iPhone & iPad

Carica dal menu di condivisione di qualsiasi app (Foto, File, Safari, uno screenshot) e ottieni il link negli appunti. Nessuna app da installare e nessun account necessario.

Per crearlo tu stesso nell'app Comandi rapidi (circa due minuti):

  1. Nuovo comando rapido, chiamalo "Upload to YourImageShare". Nei dettagli, attiva Mostra nel foglio di condivisione e accetta immagini e contenuti multimediali.
  2. Aggiungi Ottieni contenuti dell'URL: URL https://yourimageshare.com/api/widget, metodo POST, corpo della richiesta Modulo con due campi: uploads (File) = Input del comando rapido e client (Testo) = ios-shortcut.
  3. Aggiungi Ottieni valore del dizionario per data, poi un altro per src: è il link diretto.
  4. Aggiungi Copia negli appunti e Mostra notifica ("Link copiato").

Senza chiave, i caricamenti sono anonimi e non in elenco, con un limite giornaliero. Aggiungi un header X-API-Key con la tua chiave solo caricamento (Il mio account > API) per caricare nel tuo account. La risposta contiene anche delete_url se vuoi conservare un link di eliminazione.

PicGo & PicList

PicGo e PicList caricano le immagini incollate o trascinate negli editor Markdown (Typora, VS Code, Obsidian, Joplin) e inseriscono il link nel testo. Il nostro plugin rende YourImageShare uno dei loro siti di hosting immagini.

  • In PicGo o PicList: Plugin, cerca yourimageshare, installa, poi scegli YourImageShare come servizio di caricamento. Da riga di comando: picgo install yourimageshare
  • Oppure scarica il plugin e importalo come plugin locale (prima decomprimilo)
  • Impostazioni: chiave solo caricamento (facoltativa: se vuota = caricamenti anonimi e non in elenco), visibilità e se restituire il link diretto all'immagine (per Markdown) o il link della pagina
  • Il link restituito continua a funzionare quando le immagini grandi vengono poi ottimizzate in WebP

Scarica il plugin PicGo

Bot Telegram

Ottieni un link per una foto, un video o una GIF senza uscire da Telegram. Invialo a @YourImageShare_bot e il link ti torna subito indietro: niente account e nessuna chiave API. Il bot carica tramite lo stesso endpoint /api descritto qui sopra.

  • Invia una foto, un video, una GIF o un file immagine o video; un album fino a 10 elementi torna in un'unica risposta
  • In un gruppo, rispondi con /link a una foto o a un video e il bot pubblica il suo link per tutti
  • /autodelete fa sì che i tuoi prossimi caricamenti si eliminino da soli dopo 1 ora, 1 giorno, 1 settimana o 30 giorni
  • Ogni risultato ha un pulsante Elimina che funziona solo per la persona che ha caricato il file
  • I link sono non in elenco: solo chi ha il link può vedere il file
  • Il bot risponde nella lingua del tuo Telegram quando il sito è disponibile in quella lingua

Mantieni la qualità originale: Telegram comprime le foto inviate nel modo normale. Inviale come file (📎 → File) e viene caricato l'originale. Telegram permette ai bot di scaricare file fino a 20 MB, quindi carica i file più grandi sul sito.

Apri @YourImageShare_bot su Telegram

Bot Discord

Trasforma qualsiasi immagine, GIF o video di Discord in un link permanente. I link degli allegati di Discord smettono di funzionare dopo un po'; quelli di YourImageShare no. Nessun account e nessuna chiave API. Il bot carica tramite lo stesso endpoint /api descritto qui sopra.

  • /upload con un file: eliminazione automatica facoltativa dopo 1, 7 o 30 giorni, e only_me per mostrare il link solo a te
  • Clic destro su un messaggio → App → Rehost on YourImageShare per ricaricare in un'unica risposta fino a 6 immagini o video del messaggio
  • Aggiungilo a un server, oppure al tuo account per usarlo in qualsiasi chat o messaggio diretto
  • Ogni risultato ha un pulsante Elimina che funziona solo per la persona che ha caricato il file
  • I link sono non in elenco: solo chi ha il link può vedere il file

Aggiungi YourImageShare a Discord

GitHub Action per Playwright & Cypress

Quando i test end-to-end falliscono in una pull request, scopri il perché senza scaricare gli zip degli artifact. L'action carica gli screenshot degli errori e i confronti visivi e li mostra come immagini in un unico commento della pull request, aggiornato a ogni esecuzione.

  • Funziona con Playwright e Cypress e capisce da solo quale dei due usa il progetto
  • I confronti visivi falliti compaiono come Expected, Actual e Diff, con un link a un cursore prima/dopo (toHaveScreenshot di Playwright; per Cypress i plugin cypress-image-diff-js e cypress-visual-regression)
  • Il commento passa a "all tests passed" una volta corretti i test; lo stesso report va nel riepilogo del job
  • Gli screenshot sono privati (solo file immagine, nessuna pagina) e per impostazione predefinita vengono eliminati dopo 30 giorni
  • Richiede la tua chiave solo caricamento come secret del repository YOURIMAGESHARE_API_KEY; non fa mai fallire la tua build
- uses: yourimageshare/playwright-pr-screenshots@v1
  if: always()
  with:
    api-key: ${{ secrets.YOURIMAGESHARE_API_KEY }}

Guida alla configurazione su GitHub

Progetti della community

Alcune delle migliori integrazioni di YourImageShare sono create da chi lo usa. Questi progetti sono stati realizzati da membri della community con l'API pubblica descritta qui sopra. Sono mantenuti dai loro autori, quindi per domande o segnalazioni di bug contatta l'autore dalla pagina del progetto.

  • YourImageShare Uploads for FlatBB - un plugin per il forum FlatBB di madromas (MadWay Inc.).
    • Aggiunge un pulsante di caricamento all'editor dei messaggi di FlatBB: scegli una o più immagini o video e il Markdown viene inserito dove si trova il cursore
    • Inserisce ogni caricamento come anteprima cliccabile, immagine a dimensione piena o semplice link (i video come link)
    • I caricamenti passano dal server del tuo forum con una chiave API solo caricamento, così la chiave non raggiunge mai i browser dei visitatori
    • I file sono ospitati su YourImageShare, non sul disco del tuo forum, con una visibilità predefinita a tua scelta (privata, non in elenco o pubblica)
    • Funziona insieme al caricamento integrato di FlatBB, con un limite di dimensione dei file separato

    Codice sorgente su GitHub · Pagina sul FlatBB Marketplace

Grazie

Un grande grazie a tutti quelli che creano qualcosa con YourImageShare e condividono il loro lavoro con gli altri. I progetti della community portano YourImageShare in posti che non avremmo mai raggiunto da soli. Hai creato qualcosa con l'API? Raccontacelo e saremo felici di aggiungerlo qui.

Dal blog

Pronto a provarla?

Ottieni la tua chiave API →