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.

PoleTypWymaganeOpis
uploadsplikjedno z tych trzechPlik 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.
urlstringPubliczny link http(s) do zdjęcia lub wideo. Pobieramy go sami, więc działają pliki do 200MB.
upload_idstringPlik wysłany wcześniej we fragmentach przez POST /api/chunk, do 200MB.
filenamestringnieRazem z upload_id: oryginalna nazwa pliku.
expires_inintegernieAutomatycznie 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_duplicatebooleannieZapisz nową kopię, nawet jeśli twoje konto przesłało już dokładnie ten sam plik (zobacz duplicate poniżej).
keep_originalbooleannieZachowaj 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.
visibilitystringnieunlisted (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.
titlestringnieDo 90 znaków, wyświetlany na stronie przesłanego pliku.
descriptionstringnieDo 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"
  }
}
PoleOpis
idUnikalny identyfikator pliku.
typeimage lub video.
pathAdres 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.
srcStały, bezpośredni link do pliku – zawsze otwiera aktualny plik, nadaje się do src w <img>/<video> i do zapisania.
directStrona pliku w YourImageShare (tytuł, opis, komentarze, opcje udostępniania).
thumbMiniatura WebP o szerokości 280px (dla wideo – jego pierwsza klatka) lub null.
width, heightWymiary wyświetlania w pikselach (po obróceniu do pionu; dla wideo – rozmiar klatki) lub null, jeśli nieznane.
sizeRozmiar zapisanego pliku w bajtach.
lockedtrue, jeśli przesłany plik jest chroniony hasłem.
visibilityprivate, unlisted lub public (zobacz pole zapytania powyżej).
title, descriptionTak, jak ustawiono, lub null. Tekst przechodzi tę samą moderację co na stronie.
delete_urlTylko 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_atZnacznik czasu ISO 8601, kiedy to przesłanie zostanie automatycznie usunięte, lub null, jeśli nie wygasa.
duplicatetrue, 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:

  1. Wybierz identyfikator przesyłania: 32 losowe znaki szesnastkowe.
  2. Dla każdego fragmentu wyślij POST /api/chunk (multipart/form-data) z upload_id, index (od 0), total (liczba fragmentów) i bajtami w chunk. Odpowiedź to {"type": "success", "chunk_size": 5242880}.
  3. POST /api z upload_id i filename zamiast uploads, 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ę.

ParametrGdzieWymaganyOpis
pagequerynieNumer 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.

OknoDomyślny limitZakres
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 000na konto, wszystkie jego klucze razem
Na minutę300 fragmentówna 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." }
StatusZnaczenie
401Brak klucza API lub klucz nieprawidłowy.
403Konto lub twój obecny adres IP ma zakaz przesyłania.
404Nie znaleziono przesłania o tym id na tym koncie (pobieranie, zmiana, usuwanie).
413Zapytanie przekracza 100MB. Wyślij plik we fragmentach (POST /api/chunk) albo podaj link do niego w url (do 200MB).
422Błą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).
429Przekroczono limit zapytań – zobacz Limity zapytań powyżej.
500Po 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.

Pobierz YourImageShare.sxcu

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.

Pobierz dla phpBB

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.

Pobierz dla SMF

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.

Pobierz dla MyBB

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.

Przycisk „Prześlij” na dowolną stronę

Daj odwiedzającym przycisk „Prześlij” na dowolnej stronie – w formularzu komentarza, na stronie wsparcia, na forum, do którego nie mamy wtyczki, na stronie statycznej. Wklej dwie linijki; bez rejestracji i bez kodu po stronie serwera.

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

Oba atrybuty są opcjonalne: bez nich przycisk pokazuje linki z przyciskiem Kopiuj. Okno przesyłania jest zbudowane wokół linku.

  • Przesyłanie odbywa się prosto na twojej stronie: kliknij przycisk, upuść na niego pliki lub wklej zrzut ekranu – kilka plików naraz, z paskiem postępu i miniaturą
  • Zdjęcia wklejone lub upuszczone bezpośrednio w pole wskazane w data-target (dowolny textarea, input lub edytowalny blok) też są przesyłane, a linki trafiają do tego pola; bez celu pojawiają się pod przyciskiem z przyciskiem Kopiuj
  • data-format: url (bezpośredni link do pliku, domyślnie), page, bbcode, html lub markdown; data-label zmienia tekst przycisku
  • data-key (opcjonalnie): twój klucz tylko do przesyłania (Moje konto > API). Pliki trafiają wtedy na twoje konto i podlegają twoim limitom. Bez klucza przesyłanie jest anonimowe i niepubliczne (unlisted), z dziennym limitem na odwiedzającego i na stronę
  • Programiści mogą nasłuchiwać zdarzenia yis:upload w oknie przesyłania: event.detail.item zawiera {id, type, page, url, thumb}
  • Pliki do 95 MB przez przycisk (większe na stronie). Obowiązuje nasza moderacja i regulamin jak zwykle; każdy odwiedzający dostaje własny link do usunięcia

Przycisk jest rysowany we własnym, izolowanym polu, więc CSS twojej strony nie może go zepsuć. Mały link „Image and video hosting by YourImageShare” pozostaje widoczny w oknie przesyłania.

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

  1. Nowy skrót, nazwij go „Upload to YourImageShare”. W jego szczegółach włącz Show in Share Sheet i akceptuj obrazy oraz multimedia.
  2. Dodaj Get Contents of URL: URL https://yourimageshare.com/api/widget, metoda POST, treść zapytania Form z dwoma polami: uploads (File) = Shortcut Input oraz client (Text) = ios-shortcut.
  3. Dodaj Get Dictionary Value dla data, a potem kolejną dla src – to bezpośredni link.
  4. 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

Pobierz wtyczkę PicGo

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 /link na zdjęcie lub wideo, a bot opublikuje jego link dla wszystkich
  • /autodelete sprawia, ż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.

Otwórz @YourImageShare_bot w Telegramie

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.

  • /upload z 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

Dodaj YourImageShare do Discorda

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 (toHaveScreenshot w 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 }}

Instrukcja konfiguracji na GitHubie

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

    Kod źródłowy na GitHubie · Strona w FlatBB Marketplace

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

Gotowy, żeby spróbować?

Zdobądź klucz API →