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.
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
uploads | file | uno di questi tre | Il 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. |
url | stringa | Un link http(s) pubblico a un'immagine o a un video. Lo scarichiamo noi, quindi funzionano file fino a 200MB. | |
upload_id | stringa | Un file inviato prima a pezzi a POST /api/chunk, fino a 200MB. | |
filename | stringa | no | Con upload_id: il nome originale del file. |
expires_in | intero | no | Elimina 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_duplicate | booleano | no | Salva una nuova copia anche se il tuo account ha già caricato esattamente lo stesso file (vedi duplicate sotto). |
keep_original | booleano | no | Mantiene 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. |
visibility | stringa | no | unlisted (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. |
title | stringa | no | Fino a 90 caratteri, mostrato nella pagina del caricamento. |
description | stringa | no | Fino 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"
}
} | Campo | Descrizione |
|---|---|
id | L'identificatore univoco del file. |
type | image oppure video. |
path | L'indirizzo di archiviazione del file così come caricato. Può cambiare poco dopo quando il file viene convertito (WebP/MP4), quindi salva src, non path. |
src | Link diretto e permanente al file: apre sempre il file attuale, adatto per l'attributo src di <img>/<video> e per il salvataggio. |
direct | La pagina del file su YourImageShare (titolo, descrizione, commenti, opzioni di condivisione). |
thumb | Un'anteprima WebP larga 280px (per un video, il primo fotogramma), oppure null. |
width, height | Dimensioni di visualizzazione in pixel (in verticale; per un video, la dimensione del fotogramma), oppure null se non note. |
size | Dimensione del file in byte così come salvato. |
locked | true se il caricamento è protetto da password. |
visibility | private, unlisted oppure public (vedi il campo della richiesta sopra). |
title, description | Come impostati, oppure null. Il testo passa attraverso la stessa moderazione del sito. |
delete_url | Solo 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_at | Data e ora ISO 8601 in cui questo caricamento verrà eliminato automaticamente, oppure null se non scade. |
duplicate | true 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:
- Scegli un id di caricamento: 32 caratteri esadecimali casuali.
- Per ogni pezzo, fai
POST /api/chunk(multipart/form-data) conupload_id,index(da 0),total(numero di pezzi) e i byte inchunk. La risposta è{"type": "success", "chunk_size": 5242880}. - Fai
POST /apiconupload_idefilenameal posto diuploads, 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.
| Parametro | Dove | Obbligatorio | Descrizione |
|---|---|---|---|
page | query | no | Numero 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.
| Intervallo | Limite predefinito | Ambito |
|---|---|---|
| Al minuto | 20 richieste | per chiave API |
| Al giorno | 500 richieste | per chiave API completa |
| Al giorno | 2.000 richieste | per chiave solo caricamento (plugin che spostano intere librerie di media) |
| Al giorno | 2.000 richieste | per indirizzo IP |
| Al mese (UTC) | 3.000 caricamenti | per account, tutte le sue chiavi insieme |
| Al minuto | 300 pezzi | per 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." } | Stato | Significato |
|---|---|
| 401 | Chiave API mancante o non valida. |
| 403 | L'account o il tuo IP attuale è stato bloccato dai caricamenti. |
| 404 | Nessun caricamento corrispondente a quell'id su questo account (consultazione, modifica, eliminazione). |
| 413 | La richiesta supera i 100MB. Invia invece il file a pezzi (POST /api/chunk) o un link al file in url (fino a 200MB). |
| 422 | Errore 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). |
| 429 | Limite di richieste superato: vedi i limiti di richieste qui sopra. |
| 500 | Qualcosa è 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.
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.
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.
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.
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.
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):
- Nuovo comando rapido, chiamalo "Upload to YourImageShare". Nei dettagli, attiva Mostra nel foglio di condivisione e accetta immagini e contenuti multimediali.
- Aggiungi Ottieni contenuti dell'URL: URL
https://yourimageshare.com/api/widget, metodoPOST, corpo della richiesta Modulo con due campi:uploads(File) = Input del comando rapido eclient(Testo) =ios-shortcut. - Aggiungi Ottieni valore del dizionario per
data, poi un altro persrc: è il link diretto. - 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
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
/linka una foto o a un video e il bot pubblica il suo link per tutti /autodeletefa 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.
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.
/uploadcon 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
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 (
toHaveScreenshotdi 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 }} 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
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
Guide e tutorial per sviluppatori
- Carica screenshot al volo con ShareX, Flameshot o Greenshot
- Aggiungi un vero pulsante per caricare immagini al tuo forum phpBB, SMF o MyBB
- Come usare MCP: collega Claude, ChatGPT e gli agenti IA a YourImageShare
- YourImageShare Capture: l'estensione per screenshot per Chrome e Firefox
- Sposta la Libreria dei media di WordPress su un hosting immagini gratuito
- Bot Telegram di YourImageShare: ottieni un link per qualsiasi foto o video
Pronto a provarla?
Ottieni la tua chiave API →