Dokumentacja API
API YourImageShare pozwala przesyłać, listować i usuwać pliki programowo. To niewielkie API JSON/REST – bez SDK, wystarczy klient HTTP i klucz API – dostępne są też oficjalne biblioteki JavaScript, Python i MCP.
Wszystkie biblioteki klienckie i narzędzia poniżej są open source. Przeglądaj kod, zgłaszaj problemy lub współtwórz go w naszym oficjalnym repozytorium na GitHubie: github.com/yourimageshare/yourimageshare.
Bazowy URL: https://yourimageshare.com/api · Format: JSON na wejściu i wyjściu, poza przesyłaniem plików, które używa multipart/form-data · Uwierzytelnianie: klucz API w każdym zapytaniu. · Specyfikacja maszynowa: /openapi.json (OpenAPI 3.1), dla agentów i narzędzi do generowania kodu, które nie chcą parsować tej strony.
Jak zdobyć klucz API
Zaloguj się, przejdź do Moje konto i otwórz zakładkę API. Znajdziesz tam swój klucz i przycisk Wygeneruj ponownie. Ponowne wygenerowanie klucza natychmiast unieważnia stary, więc zaktualizuj go wszędzie, gdzie jest używany, zanim klikniesz.
Ta zakładka zawiera też drugi, niezależny klucz tylko do przesyłania – zobacz wskazówkę poniżej oraz Wtyczki do forów, żeby dowiedzieć się, kiedy go użyć.
Uwierzytelnianie
Przekaż klucz w nagłówku – to zalecana metoda, bo parametry zapytania często trafiają do logów dostępu, logów proxy i nagłówków Referer:
X-API-Key: YOUR_API_KEY Działa też parametr ?key=, zachowany dla zgodności ze starszymi integracjami i szybkich, jednorazowych poleceń curl. Jeśli podasz oba, nagłówek ma pierwszeństwo.
?key=YOUR_API_KEY Wskazówka: traktuj klucz jak hasło – każdy, kto go ma, może przesyłać, listować, zmieniać i usuwać pliki na twoim koncie. Każde udane zapytanie jest zapisywane i widoczne na wykresie w zakładce API na stronie konta, z podziałem na dni i typy zapytań. Jeśli klucz musi być w miejscu widocznym dla innych – we wtyczce do forum albo publicznym pliku konfiguracyjnym – użyj klucza tylko do przesyłania z tej samej zakładki: pozwala on wyłącznie przesyłać pliki – listowanie, pobieranie, zmiana i usuwanie zwracają wtedy błąd 401.
Endpointy
Przesyłanie, listowanie i usuwanie mają to samo uwierzytelnianie i te same limity; duże pliki można najpierw wysłać we fragmentach.
POST /api – prześlij plik
Przesyła jeden plik dla uwierzytelnionego konta.
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
uploads | plik | jedno z tych trzech | Plik do przesłania, do 100MB (limit pojedynczego zapytania przez naszą sieć). Jeden plik na zapytanie – ten endpoint nie obsługuje przesyłania wielu plików naraz. |
url | string | Publiczny link http(s) do zdjęcia lub wideo. Pobieramy go sami, więc działają pliki do 200MB. | |
upload_id | string | Plik wysłany wcześniej we fragmentach przez POST /api/chunk, do 200MB. | |
filename | string | nie | Razem z upload_id: oryginalna nazwa pliku. |
expires_in | integer | nie | Automatycznie usuń to przesłanie po tylu sekundach (od 60 do 31 536 000, czyli od 1 minuty do 1 roku). Pomiń, by przesłać plik normalnie i na stałe. |
allow_duplicate | boolean | nie | Zapisz nową kopię, nawet jeśli twoje konto przesłało już dokładnie ten sam plik (zobacz duplicate poniżej). |
keep_original | boolean | nie | Zachowaj zdjęcie dokładnie w takiej postaci, w jakiej je przesłano. Bez tego pliki JPG/PNG powyżej 1 MB są optymalizowane do WebP. Metadane, takie jak GPS, są usuwane w obu przypadkach. |
visibility | string | nie | unlisted (domyślnie): plik i jego strona działają dla każdego, kto ma link, ale nie są nigdzie wyświetlane. private: tylko plik – link do strony przekierowuje wszystkich poza tobą prosto do pliku (bez komentarzy, reakcji i reklam). public: widoczny na stronie i indeksowany. |
title | string | nie | Do 90 znaków, wyświetlany na stronie przesłanego pliku. |
description | string | nie | Do 500 znaków. |
Akceptowane typy: zdjęcia JPG, PNG, GIF, WEBP, AVIF, BMP, TIFF, HEIC lub HEIF; wideo MP4, WEBM, AVI, MOV, MKV, MPEG, WMV, FLV lub 3GP (dokładna lista może się z czasem rozszerzać). HEIC/HEIF i TIFF są zapisywane jako WebP, wideo inne niż MP4/WebM jest konwertowane do MP4, a większe obrazy JPEG/PNG są wkrótce po przesłaniu konwertowane do WebP, jeśli znacząco zmniejsza to ich rozmiar. Maksymalny rozmiar: 200MB; zbyt duże lub nieczytelne pliki są odrzucane z błędem 422.
Odpowiedź – 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"
}
} | Pole | Opis |
|---|---|
id | Unikalny identyfikator pliku. |
type | image lub video. |
path | Adres pliku w magazynie w takiej postaci, w jakiej go przesłano. Może się wkrótce zmienić po konwersji pliku (WebP/MP4), więc zapisuj src, a nie path. |
src | Stały, bezpośredni link do pliku – zawsze otwiera aktualny plik, nadaje się do src w <img>/<video> i do zapisania. |
direct | Strona pliku w YourImageShare (tytuł, opis, komentarze, opcje udostępniania). |
thumb | Miniatura WebP o szerokości 280px (dla wideo – jego pierwsza klatka) lub null. |
width, height | Wymiary wyświetlania w pikselach (po obróceniu do pionu; dla wideo – rozmiar klatki) lub null, jeśli nieznane. |
size | Rozmiar zapisanego pliku w bajtach. |
locked | true, jeśli przesłany plik jest chroniony hasłem. |
visibility | private, unlisted lub public (zobacz pole zapytania powyżej). |
title, description | Tak, jak ustawiono, lub null. Tekst przechodzi tę samą moderację co na stronie. |
delete_url | Tylko dla nowych przesłań: prywatny link, który usuwa to przesłanie bez klucza API. Pokazany jeden raz (przechowujemy tylko hash) – zachowaj go, jeśli będzie ci potrzebny. |
expires_at | Znacznik czasu ISO 8601, kiedy to przesłanie zostanie automatycznie usunięte, lub null, jeśli nie wygasa. |
duplicate | true, jeśli twoje konto przesłało już dokładnie ten sam plik: zwracane jest tamto przesłanie i nic nowego nie jest zapisywane. Nie dotyczy wygasających przesłań ani allow_duplicate=1. |
Wygasające przesłania: po upływie expires_at plik jest usuwany z magazynu, a strona przesłanego pliku w ciągu około 5 minut zaczyna zwracać 410 Gone. Nie można tego cofnąć ani przedłużyć – usuń plik wcześniej przez endpoint DELETE, jeśli chcesz go usunąć szybciej, albo prześlij go ponownie z nowym expires_in, jeśli ma przetrwać dłużej.
POST /api/chunk – duże pliki
Jedno zapytanie może zawierać maksymalnie 100MB. Większe pliki (do 200MB) albo mniejsze zapytania na wolnym łączu wyślij we fragmentach po maksymalnie 5MB, a na końcu wywołaj POST /api:
- Wybierz identyfikator przesyłania: 32 losowe znaki szesnastkowe.
- Dla każdego fragmentu wyślij
POST /api/chunk(multipart/form-data) zupload_id,index(od 0),total(liczba fragmentów) i bajtami wchunk. Odpowiedź to{"type": "success", "chunk_size": 5242880}. POST /apizupload_idifilenamezamiastuploads, plus dowolne inne pola przesyłania. Odpowiedź jest taka sama jak przy zwykłym przesłaniu.
Fragmenty nieukończonego przesyłania są usuwane po 2 godzinach. Do limitów przesyłania liczy się tylko kończące wywołanie POST /api.
GET /api/{id} i PATCH /api/{id} – jedno przesłanie
GET zwraca jedno z twoich przesłań z tymi samymi polami co lista poniżej. PATCH zmienia jego visibility, title lub description (pola formularza lub JSON; pusty tytuł lub opis czyści pole) i zwraca zaktualizowane przesłanie. Oba wymagają pełnego klucza API; 404, jeśli na twoim koncie nie ma takiego przesłania.
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 – zastąp plik
Podmienia plik w jednym z twoich przesłań, zachowując jego id, stronę i wszystkie linki. Działa każdy dozwolony typ, nawet inny niż poprzedni (zdjęcie może stać się wideo). Wyślij nowy plik jako uploads (albo upload_id pliku wysłanego we fragmentach przez POST /api/chunk); keep_original działa tak jak przy przesyłaniu. Nowy plik przechodzi te same kontrole i konwersje co nowe przesłanie, a poprzednia wersja jest usuwana. Wymaga pełnego klucza API; 404, jeśli na twoim koncie nie ma takiego przesłania, 409, jeśli jest chronione hasłem lub ma limit wyświetleń.
curl -X POST https://yourimageshare.com/api/aB3xY9qRz1/replace \
-H "X-API-Key: YOUR_API_KEY" -F uploads=@new-version.png GET /api – lista twoich przesłań
Zwraca stronicowaną listę przesłań uwierzytelnionego konta (z dowolnego źródła – API, strony lub edytora), od najnowszych, po 50 na stronę.
| Parametr | Gdzie | Wymagany | Opis |
|---|---|---|---|
page | query | nie | Numer strony, domyślnie 1. |
Odpowiedź – 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 }
} Pola znaczą tu to samo co w odpowiedzi na przesłanie powyżej (dla przesłania chronionego hasłem path i thumb to krótkotrwałe podpisane linki). Aby pobrać jedno przesłanie po jego id, użyj GET /api/{id}.
DELETE /api/{id} – usuń przesłanie
Trwale usuwa jedno z przesłań uwierzytelnionego konta. Nie można tego cofnąć przez API. {id} to wartość zwracana jako id przez endpointy przesyłania i listowania.
Odpowiedź – 200 OK:
{ "type": "success", "msg": "Deleted." } 404, jeśli na twoim koncie nie ma przesłania o tym id (albo nigdy do ciebie nie należało, albo zostało już usunięte).
POST /api/compare – suwak przed/po
Tworzy porównanie przed/po dwóch twoich przesłanych zdjęć: stronę z suwakiem pod adresem /c/{id}, którą można też osadzić na dowolnej stronie. Działa także klucz tylko do przesyłania. Wyślij before i after (id przesłań, wymagane) oraz opcjonalnie title, label_before i label_after (domyślnie „Before” i „After”).
Odpowiedź – 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, jeśli któreś id nie jest jednym z twoich przesłanych zdjęć (wideo i zdjęć chronionych hasłem nie można użyć).
Limity zapytań
Każdy klucz API ma niezależne limity na minutę i na dzień, a do tego ogólniejszy dzienny limit na adres IP, który chroni przed jednym IP używającym wielu kluczy. Przesyłanie, listowanie i usuwanie mają wspólne limity.
| Okno | Domyślny limit | Zakres |
|---|---|---|
| Na minutę | 20 zapytań | na klucz API |
| Na dzień | 500 zapytań | na pełny klucz API |
| Na dzień | 2 000 zapytań | na klucz tylko do przesyłania (wtyczki przenoszące całe biblioteki mediów) |
| Na dzień | 2 000 zapytań | na adres IP |
| Miesięcznie (UTC) | Przesłane pliki: 3 000 | na konto, wszystkie jego klucze razem |
| Na minutę | 300 fragmentów | na klucz API, tylko POST /api/chunk |
Miesięczny limit przesyłania. Każde konto może przesłać 3 000 plików miesięcznie przez API, licząc wszystkie jego klucze i narzędzia, które ich używają (SDK, wtyczki, rozszerzenia przeglądarki, MCP z kluczem). Liczą się tylko udane przesyłania: listy, usuwanie i nieudane żądania nie, a plik wysłany w kawałkach liczy się raz. Licznik zeruje się 1. dnia każdego miesiąca (UTC). Licznik z tego miesiąca zobaczysz w Moje konto > API. Po przekroczeniu limitu POST /api zwraca 429 z datą resetu. Limit obowiązuje od 1 stycznia 2027.
Te limity mogą się zmieniać. Każda odpowiedź zawiera standardowe nagłówki limitów:
X-RateLimit-Limit: 20
X-RateLimit-Remaining: 14 Po przekroczeniu limitu zwracany jest kod 429 z nagłówkiem Retry-After, który mówi, ile sekund poczekać.
Błędy
Każda odpowiedź z błędem ma ten sam format, niezależnie od endpointu i przyczyny:
{ "type": "error", "errors": "A human-readable description of what went wrong." } | Status | Znaczenie |
|---|---|
| 401 | Brak klucza API lub klucz nieprawidłowy. |
| 403 | Konto lub twój obecny adres IP ma zakaz przesyłania. |
| 404 | Nie znaleziono przesłania o tym id na tym koncie (pobieranie, zmiana, usuwanie). |
| 413 | Zapytanie przekracza 100MB. Wyślij plik we fragmentach (POST /api/chunk) albo podaj link do niego w url (do 200MB). |
| 422 | Błąd walidacji – nie podano pliku ani linku, nieobsługiwany typ pliku, nieczytelne dane obrazu, wymiary powyżej limitu 30000x30000px, plik większy niż 200MB, nieukończone lub wygasłe upload_id albo url, którego nie udało się pobrać (komunikat podaje powód). |
| 429 | Przekroczono limit zapytań – zobacz Limity zapytań powyżej. |
| 500 | Po stronie serwera wystąpił nieoczekiwany błąd. Można bezpiecznie spróbować ponownie. |
Biblioteki klienckie
Oficjalne SDK opakowujące powyższe endpointy, ze zwracanymi typowanymi wynikami i zgłaszaniem błędów API zamiast ręcznej obsługi HTTP.
JavaScript / TypeScript
Bez zależności, działa w Node.js i przeglądarkach. Dostępne też w JSR jako @yourimageshare/yourimageshare – npx jsr add @yourimageshare/yourimageshare – to samo źródło, publikowane bezpośrednio jako TypeScript.
npm install yourimageshare Python
Jedna zależność (requests), Python 3.8+.
pip install yourimageshare PHP
Bez zależności Composera (używa wbudowanego rozszerzenia curl), PHP 7.4+. Kod źródłowy na GitHubie.
composer require yourimageshare/yourimageshare-php Go
Bez zależności (tylko biblioteka standardowa), Go 1.18+. Pełną dokumentację znajdziesz na pkg.go.dev.
go get github.com/yourimageshare/yourimageshare/go Rust
Dwie zależności (ureq do blokującego HTTP – bez środowiska async – oraz serde), Rust 1.70+. Kod źródłowy na GitHubie.
cargo add yourimageshare Ruby
Bez zależności gem (biblioteka standardowa Net::HTTP + json), Ruby 2.7+. Kod źródłowy na GitHubie.
gem install yourimageshare .NET
Jedna zależność (własna biblioteka Microsoftu System.Text.Json), celuje w netstandard2.0, więc działa zarówno z .NET Framework, jak i nowoczesnym .NET. Kod źródłowy na GitHubie. Zbudowane i sprawdzone na tym działającym API; publikacja w NuGet wkrótce.
dotnet add package YourImageShare Dart / Flutter
Jedna zależność (http, pakiet zespołu Darta), Dart 2.17+. Kod źródłowy na GitHubie. Zbudowane i sprawdzone na tym działającym API; publikacja w pub.dev wkrótce.
dart pub add yourimageshare Elixir
Jedna zależność (Req), Elixir 1.14+. Zwraca krotki {:ok, result}| {:error, reason} – bezpośredni odpowiednik obsługi błędów tego API w każdym innym SDK – oraz warianty z wykrzyknikiem, które zgłaszają wyjątek. Kod źródłowy na GitHubie, dokumentacja na HexDocs.
{:yourimageshare, "~> 1.1"} Serwer MCP
Dla agentów AI do programowania (Claude Code, Cursor i inne narzędzia zgodne z MCP) – wklej zrzut ekranu do zgłoszenia błędu, opisu PR lub wątku wsparcia jako prawdziwy link, zamiast bloba base64 czy ręcznego przesyłania. Działa tak samo z Claude Desktop i każdym innym klientem MCP.
Wersja hostowana, nic nie musisz instalować: dodaj ją jako zdalny serwer MCP (w Claude: Settings › Connectors › Add custom connector; także ChatGPT, Cursor, VS Code i inni klienci przyjmujący adres serwera) z kluczem API w adresie:
https://yourimageshare.com/mcp?key=YOUR_API_KEY Klienci, którzy pozwalają ustawiać nagłówki, mogą zamiast tego użyć https://yourimageshare.com/mcp z Authorization: Bearer YOUR_API_KEY. Adres z kluczem działa jak hasło: trzymaj go w tajemnicy, a jeśli wycieknie, wygeneruj nowy klucz w Moje konto. Na serwerze hostowanym upload_image przyjmuje publiczny link (do 200MB) lub zawartość base64 w treści zapytania (do 15MB). Bez klucza https://yourimageshare.com/mcp nadal przesyła pliki anonimowo, jak strona: tylko jako niepubliczne (unlisted) lub prywatne, z niższymi limitami, a przesłany plik usuwasz za pomocą zwróconego delete_url. Pozostałe narzędzia wymagają klucza.
Lokalnie: uruchom go bezpośrednio przez npx, bez instalacji (może też czytać pliki z twojego dysku):
npx yourimageshare-mcp Narzędzia: upload_image (plik lokalny, zawartość w treści zapytania lub link, do 200MB, z opcjonalną widocznością, tytułem i automatycznym usunięciem), list_uploads, get_upload, update_upload i delete_upload.
Dostępny też w oficjalnym rejestrze MCP (jako io.github.yourimageshare/yourimageshare) i wymieniony w Glama, jeśli twój klient MCP instaluje serwery z jednego z tych miejsc.
Nowy w MCP? Zobacz jak połączyć Claude i ChatGPT z tym API przez MCP – pełny opis konfiguracji.
Wszystkie dziesięć jest na licencji MIT. Nie ma oficjalnej biblioteki dla twojego języka? Przykłady kodu poniżej pokazują, jak wywoływać API bezpośrednio.
Przykłady kodu
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)
Oficjalne SDK dla Go powyżej robi to za ciebie – ta surowa wersja jest dla tych, którzy wolą nie dodawać zależności.
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
} Narzędzia do zrzutów ekranu
Rozszerzenie do przeglądarki oraz gotowe konfiguracje i skrypty, które wysyłają zrzuty ekranu prosto do YourImageShare, bez ręcznego przesyłania. Każde z nich korzysta z tego samego endpointu /api opisanego powyżej.
Rozszerzenie do przeglądarki (Chrome i Firefox)
Rozszerzenie YourImageShare Capture dla Chrome i Firefox pomija skrypty i pliki konfiguracyjne. Przechwytuje widoczny obszar, zaznaczony fragment lub całą przewijaną stronę, otwiera wbudowany edytor ze strzałkami, tekstem, rozmyciem/zakrywaniem i innymi adnotacjami, a następnie pobiera wynik, kopiuje go do schowka albo publikuje w YourImageShare jednym kliknięciem. Publikowanie korzysta z tego samego endpointu /api opisanego powyżej – wpisz klucz API raz w ustawieniach rozszerzenia, a każda kolejna publikacja od razu zwraca link do udostępniania. Działa w Chrome na komputerze (i innych przeglądarkach opartych na Chromium), Firefoksie na komputerze oraz Firefoksie na Androida.
Pobierz YourImageShare Capture dla Firefoksa Pobierz YourImageShare Capture dla Chrome
ShareX
Pobierz poniższy własny uploader, a następnie w ShareX przejdź do Destinations > Custom uploader settings > Import > from file, otwórz pobrany plik .sxcu i zamień YOUR_API_KEY w polu Headers na swój prawdziwy klucz. Ustaw go jako miejsce docelowe dla obrazów/plików, a zrzuty będą przesyłane automatycznie.
Usuwanie: link „Delete” w ShareX dla każdego przesłanego pliku otwiera w przeglądarce naszą stronę usuwania (jednorazowy delete_url przesłania), więc możesz usunąć zrzut prosto z historii ShareX. Możesz też usuwać przesłane pliki w Moje konto. Konfigurację pobrano przed październikiem 2026? Pobierz ją ponownie, żeby to mieć.
Flameshot (Linux)
Mały skrypt powłoki, który uruchamia flameshot gui, przesyła zrzut i kopiuje link do schowka. Przypisz go do skrótu klawiszowego w swoim środowisku graficznym zamiast domyślnego skrótu Flameshota.
Pobierz 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)
Skrypt PowerShell dla wbudowanego w Greenshot miejsca docelowego External command. Zgodny z Windows PowerShell 5.1, który jest w systemie Windows, bez dodatkowej instalacji.
Pobierz 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" Wtyczki do forów
Dodaj prawdziwy przycisk „Prześlij zdjęcie” obok edytora postów na forum. Każda wtyczka przesyła pliki przez ten sam endpoint /api opisany powyżej i wstawia BBCode w miejscu kursora – bez osobnej karty, bez ręcznego kopiowania i wklejania.
Poniżej użyj klucza tylko do przesyłania, a nie pełnego klucza API. Każda wtyczka umieszcza klucz w kodzie źródłowym strony widocznej dla każdego odwiedzającego, a klucz tylko do przesyłania (Moje konto > zakładka API) może tylko przesyłać pliki – nie może listować ani usuwać twoich przesłań, nawet jeśli ktoś skopiuje go ze strony.
Przesyłanie z forów jest domyślnie prywatne: zdjęcie działa w poście, ale YourImageShare nie tworzy dla niego osobnej strony (bez komentarzy, reakcji i reklam). Każda wtyczka ma ustawienie przełączające na unlisted, jeśli chcesz, by każdy, kto ma link, miał też stronę.
phpBB
Prawdziwe rozszerzenie phpBB 3.2/3.3. Rozpakuj do ext/, włącz je w Customise > Manage extensions, a następnie zamień YOUR_UPLOAD_ONLY_KEY w pliku zdarzeń szablonu rozszerzenia na swój prawdziwy klucz tylko do przesyłania.
SMF (Simple Machines Forum)
Prawdziwy pakiet SMF – zainstaluj przez Admin > Package Manager, a następnie zamień YOUR_UPLOAD_ONLY_KEY w Sources/yis_forumupload.php na swój prawdziwy klucz tylko do przesyłania.
MyBB
Prawdziwa wtyczka MyBB 1.8. Skopiuj do inc/plugins/, aktywuj w Configuration > Plugins, a następnie zamień YOUR_UPLOAD_ONLY_KEY w pliku wtyczki na swój prawdziwy klucz tylko do przesyłania.
FluxBB, PunBB i ZetaBoards
Nie mają formalnego systemu wtyczek, więc to mały fragment kodu wklejany bezpośrednio do szablonu (FluxBB/PunBB) lub Admin CP (ZetaBoards) – pełne instrukcje kopiuj-wklej dla każdego:
Instrukcja dla FluxBB Instrukcja dla PunBB Instrukcja dla ZetaBoards
Wtyczka WordPress
Przenieś Bibliotekę mediów do YourImageShare zamiast trzymać ją na lokalnym dysku. Nowe zdjęcia i wideo są przesyłane automatycznie tym samym endpointem /api opisanym powyżej, lokalny plik (i każdy wygenerowany rozmiar miniatury) jest usuwany po potwierdzeniu przesłania, a każdy adres załącznika WordPressa – edytor blokowy, obrazki wyróżniające, galerie, REST API – wskazuje plik hostowany w YourImageShare. Bez shortcode’ów, bez zmiany sposobu pracy.
- Masowe przenoszenie istniejącej Biblioteki mediów w tle (lub przez
wp yis offload --all), nie tylko nowych plików - Zdjęcia i wideo już wstawione do wpisów nadal działają po usunięciu ich lokalnych plików
- Miniatury i srcset używają naszej miniatury 280px, więc małe miejsca na obrazy nie ładują plików w pełnym rozmiarze
- Pliki do 200MB, wysyłane we fragmentach, żeby duże wideo nie obciążało współdzielonego hostingu
- Przywróć dowolny przeniesiony plik do lokalnego magazynu w każdej chwili
- Kolumna w Bibliotece mediów pokazuje, co zostało przeniesione, a co nadal jest lokalne
- Przeniesione pliki są zapisywane jako prywatne: ładują się wszędzie tam, gdzie używa ich twoja strona, ale nie mają własnej strony w YourImageShare
Używa twojego klucza tylko do przesyłania, a nie klucza API. Opcjonalny pełny klucz API jest potrzebny tylko wtedy, gdy chcesz, żeby przeniesione pliki były usuwane z YourImageShare po usunięciu ich w WordPressie.
Pobierz z WordPress.org Pobierz plik ZIP
W WordPressie: Plugins > Add New, wyszukaj YourImageShare Media Offload, a potem Install i Activate.
Skrót na iPhone'a i iPada
Przesyłaj z menu udostępniania dowolnej aplikacji – Zdjęcia, Pliki, Safari, zrzut ekranu – i miej link w schowku. Bez instalowania aplikacji i bez rejestracji.
Aby zbudować go samodzielnie w aplikacji Skróty (około dwóch minut):
- Nowy skrót, nazwij go „Upload to YourImageShare”. W jego szczegółach włącz Show in Share Sheet i akceptuj obrazy oraz multimedia.
- Dodaj Get Contents of URL: URL
https://yourimageshare.com/api/widget, metodaPOST, treść zapytania Form z dwoma polami:uploads(File) = Shortcut Input orazclient(Text) =ios-shortcut. - Dodaj Get Dictionary Value dla
data, a potem kolejną dlasrc– to bezpośredni link. - Dodaj Copy to Clipboard i Show Notification („Link copied”).
Bez klucza przesyłanie jest anonimowe i niepubliczne (unlisted), z dziennym limitem. Dodaj nagłówek X-API-Key ze swoim kluczem tylko do przesyłania (Moje konto > API), aby przesyłać na swoje konto. Odpowiedź zawiera też delete_url, jeśli chcesz zachować link do usunięcia.
PicGo i PicList
PicGo i PicList przesyłają wklejone lub przeciągnięte zdjęcia dla edytorów Markdown – Typora, VS Code, Obsidian, Joplin – i wstawiają link do tekstu. Nasza wtyczka czyni YourImageShare jednym z ich hostingów zdjęć.
- W PicGo lub PicList: Plugins, wyszukaj
yourimageshare, zainstaluj, a potem wybierz YourImageShare jako uploader. Z wiersza poleceń:picgo install yourimageshare - Albo pobierz wtyczkę i zaimportuj ją jako wtyczkę lokalną (najpierw rozpakuj)
- Ustawienia: klucz tylko do przesyłania (opcjonalny – pusty = anonimowe, niepubliczne przesyłanie), widoczność oraz to, czy zwracać bezpośredni link do zdjęcia (dla Markdown), czy link do strony
- Zwracany link działa nadal, gdy duże zdjęcia zostaną później zoptymalizowane do WebP
Bot Telegram
Zdobądź link do zdjęcia, wideo lub GIF-a, nie wychodząc z Telegrama. Wyślij je do @YourImageShare_bot, a link wróci od razu – bez rejestracji i bez klucza API. Bot przesyła pliki tym samym endpointem /api opisanym powyżej.
- Wyślij zdjęcie, wideo, GIF albo plik ze zdjęciem lub wideo; album do 10 elementów wraca w jednej odpowiedzi
- W grupie odpowiedz
/linkna zdjęcie lub wideo, a bot opublikuje jego link dla wszystkich /autodeletesprawia, że twoje kolejne przesłania usuwają się same po 1 godzinie, 1 dniu, 1 tygodniu lub 30 dniach- Każdy wynik ma przycisk Usuń, który działa tylko dla osoby, która przesłała plik
- Linki są niepubliczne (unlisted): plik widzą tylko osoby, które mają link
- Bot odpowiada w języku twojego Telegrama, jeśli strona jest w nim dostępna
Zachowaj pełną jakość: Telegram kompresuje zdjęcia wysłane w zwykły sposób. Wyślij je jako plik (📎 → File), a przesłany zostanie oryginał. Telegram pozwala botom pobierać pliki do 20 MB, więc większe pliki prześlij na stronie.
Bot Discord
Zamień dowolne zdjęcie, GIF lub wideo na Discordzie w trwały link. Własne linki do załączników Discorda po jakimś czasie przestają działać; linki YourImageShare nie. Bez rejestracji i bez klucza API. Bot przesyła pliki tym samym endpointem /api opisanym powyżej.
/uploadz plikiem: opcjonalne automatyczne usunięcie po 1, 7 lub 30 dniach oraz only_me, by link widziałeś tylko ty- Kliknij wiadomość prawym przyciskiem → Apps → Rehost on YourImageShare, aby jedną odpowiedzią przenieść z niej do 6 zdjęć lub wideo
- Dodaj go do serwera albo do własnego konta, aby używać go w dowolnym czacie lub w wiadomościach prywatnych
- Każdy wynik ma przycisk Usuń, który działa tylko dla osoby, która przesłała plik
- Linki są niepubliczne (unlisted): plik widzą tylko osoby, które mają link
GitHub Action dla Playwright i Cypress
Gdy testy end-to-end w pull requeście nie przechodzą, zobacz dlaczego, bez pobierania archiwów z artefaktami. Action przesyła zrzuty ekranu z błędami i różnice wizualne, a następnie pokazuje je jako obrazy w jednym komentarzu do pull requesta, aktualizowanym przy każdym uruchomieniu.
- Działa z Playwright i Cypress i sam rozpoznaje, którego używa projekt
- Nieudane porównania wizualne pojawiają się jako Expected, Actual i Diff, z linkiem do suwaka przed/po (
toHaveScreenshotw Playwright; dla Cypress wtyczki cypress-image-diff-js i cypress-visual-regression) - Komentarz zmienia się na „all tests passed”, gdy testy zostaną naprawione; ten sam raport trafia do podsumowania zadania
- Zrzuty ekranu są prywatne (tylko pliki obrazów, bez strony) i domyślnie usuwane po 30 dniach
- Wymaga twojego klucza tylko do przesyłania jako sekretu repozytorium
YOURIMAGESHARE_API_KEY; nigdy nie psuje twojego builda
- uses: yourimageshare/playwright-pr-screenshots@v1
if: always()
with:
api-key: ${{ secrets.YOURIMAGESHARE_API_KEY }} Projekty społeczności
Niektóre z najlepszych integracji YourImageShare tworzą osoby, które z niego korzystają. Te projekty powstały dzięki członkom społeczności i publicznemu API opisanemu powyżej. Utrzymują je ich autorzy, więc z pytaniami lub zgłoszeniami błędów skontaktuj się z autorem przez stronę projektu.
- YourImageShare Uploads for FlatBB – wtyczka do forum FlatBB autorstwa madromas (MadWay Inc.).
- Dodaje przycisk przesyłania do edytora postów FlatBB: wybierz jedno lub więcej zdjęć albo wideo, a Markdown zostanie wstawiony w miejscu kursora
- Wstawia każde przesłanie jako klikalną miniaturę, zdjęcie w pełnym rozmiarze lub zwykły link (wideo jako link)
- Pliki są przesyłane przez serwer twojego forum z kluczem API tylko do przesyłania, więc klucz nigdy nie trafia do przeglądarek odwiedzających
- Pliki są hostowane w YourImageShare, a nie na dysku twojego forum, z domyślną widocznością, którą wybierasz (prywatna, niepubliczna lub publiczna)
- Działa razem z własnym uploaderem FlatBB, z osobnym limitem rozmiaru pliku
Dziękujemy
Wielkie dzięki wszystkim, którzy tworzą z YourImageShare i dzielą się swoją pracą z innymi. Projekty społeczności zanoszą YourImageShare tam, gdzie sami byśmy nigdy nie dotarli. Budujesz coś z użyciem API? Napisz do nas, a chętnie dodamy to tutaj.
Z bloga
Poradniki i instrukcje dla programistów
- Przesyłaj zrzuty ekranu natychmiast z ShareX, Flameshot lub Greenshot
- Dodaj prawdziwy przycisk przesyłania zdjęć do forum phpBB, SMF lub MyBB
- Jak używać MCP: połącz Claude, ChatGPT i agentów AI z YourImageShare
- YourImageShare Capture: rozszerzenie do zrzutów ekranu dla Chrome i Firefoksa
- Przenieś Bibliotekę mediów WordPressa na darmowy hosting zdjęć
- Bot Telegram YourImageShare: link do dowolnego zdjęcia lub wideo
Gotowy, żeby spróbować?
Zdobądź klucz API →