API dokumentacija

Kako do API ključa

Prijavite se, otvorite Moj nalog i pređite na karticu API. Tamo se prikazuje vaš ključ, zajedno sa dugmetom za ponovno generisanje (Regenerate). Ponovno generisanje ključa odmah poništava stari ključ, zato ga prvo izmenite svuda gde se koristi pa tek onda kliknite.

Na istoj kartici postoji i drugi, nezavisan ključ samo za otpremanje - pogledajte savet ispod i Dodatke za forume da vidite kada ga treba koristiti.

Autentifikacija

Pošaljite ključ kao zaglavlje - to je poželjan način, jer upiti u adresi lako završe u logovima pristupa, logovima proksija i Referer zaglavljima:

X-API-Key: YOUR_API_KEY

Radi i parametar ?key= u adresi, zadržan zbog kompatibilnosti sa starijim integracijama i brzih jednokratnih curl komandi. Ako su prisutni i jedno i drugo, zaglavlje ima prednost.

?key=YOUR_API_KEY

Endpointi

Otpremanje, listanje i brisanje dele istu autentifikaciju i ista ograničenja; veliki fajlovi mogu se prvo poslati u delovima.

POST /api - Otpremanje fajla

Otprema jedan fajl za autentifikovani nalog.

Prihvaćeni tipovi: JPG, PNG, GIF, WEBP, AVIF, BMP, TIFF, HEIC ili HEIF slike; MP4, WEBM, AVI, MOV, MKV, MPEG, WMV, FLV ili 3GP video (tačna lista može da se proširi tokom vremena). HEIC/HEIF i TIFF se čuvaju kao WebP, video osim MP4/WebM se konvertuje u MP4, a veće JPEG/PNG slike se konvertuju u WebP ubrzo nakon otpremanja kada ih to primetno smanji. Maksimalna veličina: 200MB; prevelike ili nečitljive fajlove odbijamo greškom 422.

Odgovor - 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"
  }
}

POST /api/chunk - Veliki fajlovi

Jedan zahtev može da nosi najviše 100MB. Za veće fajlove (do 200MB), ili da bi svaki zahtev ostao mali na sporoj vezi, pošaljite fajl u delovima od najviše 5MB, a zatim završite sa POST /api:

1. Izaberite id otpremanja: 32 nasumična heksadecimalna karaktera.
2. Za svaki deo, POST /api/chunk (multipart/form-data) sa upload_id, index (od 0), total (broj delova) i bajtovima u chunk. Odgovor je {"type": "success", "chunk_size": 5242880}.
3. POST /api sa upload_id i filename umesto uploads, plus bilo koje drugo polje za otpremanje. Odgovor je uobičajeni odgovor na otpremanje.

Delovi nezavršenog otpremanja brišu se nakon 2 sata. Samo završni POST /api računa se u ograničenja za otpremanje.

GET /api/{id} i PATCH /api/{id} - Jedan fajl

GET vraća jedan od vaših fajlova sa istim poljima kao u listi ispod. PATCH menja njegov visibility, title ili description (polja forme ili JSON; prazan naslov ili opis ga briše) i odgovara ažuriranim fajlom. Oba zahtevaju pun API ključ; 404 ako takvog fajla nema na vašem nalogu.

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

Zamenjuje fajl iza jednog od vaših otpremljenih fajlova i zadržava njegov id, stranicu i sve linkove. Radi bilo koji dozvoljeni tip, čak i drugačiji (slika može postati video). Pošaljite novi fajl kao uploads (ili upload_id fajla poslatog u delovima na POST /api/chunk); keep_original radi kao kod otpremanja. Novi fajl prolazi iste provere i konverzije kao novo otpremanje, a prethodna verzija se uklanja. Zahteva pun API ključ; 404 ako takvog fajla nema na vašem nalogu, 409 ako je zaštićen lozinkom ili ograničen brojem pregleda.

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

GET /api - Lista vaših fajlova

Vraća listu otpremljenih fajlova autentifikovanog naloga podeljenu na stranice (iz bilo kog izvora - API, sajt ili uređivač), najnoviji prvo, po 50 na stranici.

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

Polja ovde znače isto što i u odgovoru na otpremanje iznad (za fajl zaštićen lozinkom, path i thumb su kratkotrajni potpisani linkovi). Da biste pronašli jedan fajl po njegovom id, koristite GET /api/{id}.

DELETE /api/{id} - Brisanje fajla

Trajno briše jedan od fajlova autentifikovanog naloga. Ovo se ne može poništiti preko API-ja. {id} je vrednost koju vraćaju endpointi za otpremanje ili listanje kao id.

Odgovor - 200 OK:

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

404 ako na vašem nalogu ne postoji fajl sa tim id-jem (ili nikada nije bio vaš, ili je već obrisan).

POST /api/compare - Klizač pre/posle

Pravi poređenje pre/posle dve vaše slike: stranicu sa klizačem na /c/{id} koja se može ugraditi i na bilo koji sajt. Radi i ključ samo za otpremanje. Pošaljite before i after (id-jevi otpremljenih fajlova, obavezno), a po želji title, label_before i label_after (podrazumevano "Before" i "After").

Odgovor - 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 ako neki od id-jeva nije među vašim otpremljenim slikama (video snimci i slike zaštićene lozinkom ne mogu se koristiti).

Ograničenja zahteva

Svaki API ključ ima nezavisne kvote po minutu i po danu, plus grublje dnevno ograničenje po IP adresi kao zaštitu od toga da jedna IP adresa menja više ključeva. Otpremanje, listanje i brisanje dele ista ograničenja.

Ova ograničenja mogu da se promene. Svaki odgovor sadrži standardna zaglavlja o ograničenju:

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

Kada se ograničenje prekorači, vraća se 429 sa zaglavljem Retry-After koje kaže koliko sekundi treba čekati.

Greške

Svaki odgovor sa greškom ima isti oblik, bez obzira na endpoint ili uzrok:

{ "type": "error", "errors": "A human-readable description of what went wrong." }

Klijentske biblioteke

Zvanični SDK-ovi koji obuhvataju gore navedene endpointe, sa tipiziranim rezultatima i izuzecima za API greške umesto ručnog rada sa sirovim HTTP-om.

JavaScript / TypeScript

Bez zavisnosti, radi u Node.js-u i pregledačima. Takođe na JSR-u kao @yourimageshare/yourimageshare - npx jsr add @yourimageshare/yourimageshare - isti izvorni kod, objavljen direktno kao TypeScript.

npm install yourimageshare

Python

Jedna zavisnost (requests), Python 3.8+.

pip install yourimageshare

PHP

Bez Composer zavisnosti (koristi PHP-ovu ugrađenu curl ekstenziju), PHP 7.4+. Izvorni kod na GitHub-u.

composer require yourimageshare/yourimageshare-php

Go

Bez zavisnosti (samo standardna biblioteka), Go 1.18+. Pogledajte pkg.go.dev za punu referentnu dokumentaciju.

go get github.com/yourimageshare/yourimageshare/go

Rust

Dve zavisnosti (ureq za blokirajući HTTP - bez async runtime-a - plus serde), Rust 1.70+. Izvorni kod na GitHub-u.

cargo add yourimageshare

Ruby

Bez zavisnosti od gem-ova (standardni Net::HTTP + json), Ruby 2.7+. Izvorni kod na GitHub-u.

gem install yourimageshare

.NET

Jedna zavisnost (Microsoftov System.Text.Json), cilja netstandard2.0 pa radi i iz .NET Framework-a i iz modernog .NET-a. Izvorni kod na GitHub-u. Napravljen i proveren na ovom živom API-ju; objavljivanje na NuGet-u uskoro.

dotnet add package YourImageShare

Dart / Flutter

Jedna zavisnost (http, paket samog Dart tima), Dart 2.17+. Izvorni kod na GitHub-u. Napravljen i proveren na ovom živom API-ju; objavljivanje na pub.dev uskoro.

dart pub add yourimageshare

Elixir

Jedna zavisnost (Req), Elixir 1.14+. Vraća {:ok, result}| {:error, reason} označene torke - direktan ekvivalent rukovanja greškama ovog API-ja u svim ostalim SDK-ovima - plus varijante sa uzvičnikom koje bacaju izuzetak. Izvorni kod na GitHub-u, dokumentacija na HexDocs-u.

{:yourimageshare, "~> 1.1"}

MCP server

Za AI agente za programiranje (Claude Code, Cursor i drugi alati kompatibilni sa MCP-om) - ubacite snimak ekrana u prijavu greške, opis PR-a ili nit podrške kao pravi URL umesto base64 blokova ili ručnog otpremanja. Isto radi sa Claude Desktop-om i bilo kojim drugim MCP klijentom.

Hostovan, bez instalacije: dodajte ga kao udaljeni MCP server (u Claude-u: Settings › Connectors › Add custom connector; takođe ChatGPT, Cursor, VS Code i drugi klijenti koji prihvataju URL servera) sa vašim API ključem u URL-u:

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

Klijenti koji dozvoljavaju postavljanje zaglavlja mogu umesto toga koristiti https://yourimageshare.com/mcp sa Authorization: Bearer YOUR_API_KEY. URL sa vašim ključem radi kao lozinka: čuvajte ga privatno, a ako procuri, nabavite novi ključ u Mom nalogu. Na hostovanom serveru, upload_image prima javni link (do 200MB) ili ugrađeni base64 sadržaj (do 15MB). Bez ključa, https://yourimageshare.com/mcp i dalje otprema anonimno, kao sajt: samo unlisted ili private, niža ograničenja, a fajl se briše pomoću delete_url koji vraća. Ostali alati zahtevaju ključ.

Lokalno: pokrenite ga direktno sa npx, bez koraka instalacije (može da čita i fajlove sa vašeg diska):

npx yourimageshare-mcp

Alati: upload_image (lokalni fajl, ugrađeni sadržaj ili link, do 200MB, uz opcionu vidljivost, naslov i automatsko brisanje), list_uploads, get_upload, update_upload i delete_upload.

Takođe u zvaničnom MCP Registry-ju (kao io.github.yourimageshare/yourimageshare) i naveden na Smithery-ju i Glama-i, ako vaš MCP klijent instalira iz jednog od njih.

Prvi put čujete za MCP? Pogledajte kako da povežete Claude i ChatGPT sa ovim API-jem preko MCP-a za kompletno uputstvo za podešavanje.

Primeri koda

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)

Zvanični Go SDK iznad ovo obavlja umesto vas - ova sirova verzija je tu za one koji ne žele da dodaju zavisnost.

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
}

Alati za snimke ekrana

Ekstenzija za pregledač plus gotove konfiguracije i skripte za slanje snimaka ekrana direktno na YourImageShare, bez ručnog otpremanja. Svaki otprema preko istog /api endpointa opisanog iznad.

Ekstenzija za pregledač (Chrome i Firefox)

Ekstenzija YourImageShare Capture za Chrome i Firefox u potpunosti zaobilazi skripte i konfiguracione fajlove. Snima vidljivi deo, oblast izabranu prevlačenjem ili celu stranicu koja se skroluje, otvara ugrađeni uređivač za strelice, tekst, zamućivanje/skrivanje i druge oznake, a zatim preuzima rezultat, kopira ga u clipboard ili ga jednim klikom objavljuje direktno na YourImageShare. Objavljivanje koristi isti /api endpoint opisan iznad - dodajte svoj API ključ jednom u podešavanjima ekstenzije i svako sledeće objavljivanje odmah vraća link za deljenje. Radi u desktop Chrome-u (i drugim Chromium pregledačima), desktop Firefox-u i Firefox-u za Android.

Preuzmite YourImageShare Capture za Firefox Preuzmite YourImageShare Capture za Chrome

ShareX

Preuzmite prilagođeni uploader ispod, zatim u ShareX-u idite na Destinations > Custom uploader settings > Import > from file, otvorite preuzeti .sxcu i zamenite YOUR_API_KEY u polju Headers vašim pravim ključem. Postavite ga kao odredište za slike/fajlove i snimci se otpremaju automatski.

Preuzmite YourImageShare.sxcu

Flameshot (Linux)

Mala shell skripta koja pokreće flameshot gui, otprema snimak i kopira link u clipboard. Povežite je sa prečicom na tastaturi u vašem desktop okruženju umesto Flameshot-ove podrazumevane.

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

PowerShell skripta za Greenshot-ovo ugrađeno odredište External command. Kompatibilna sa Windows PowerShell 5.1 koji dolazi uz Windows, bez dodatne instalacije.

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

Dodaci za forume

Dodajte pravo dugme "Otpremi sliku" pored uređivača poruka na vašem forumu. Svaki otprema preko istog /api endpointa opisanog iznad i ubacuje BBCode na mesto kursora - bez posebne kartice, bez ručnog kopiranja.

Otpremanja sa foruma su podrazumevano private: slika radi u poruci, ali joj YourImageShare ne daje sopstvenu stranicu (bez komentara, reakcija i reklama). Svaki dodatak ima podešavanje za prelazak na unlisted ako želite i stranicu za svakoga ko ima link.

phpBB

Pravo phpBB 3.2/3.3 proširenje. Raspakujte u ext/, uključite ga u Customise > Manage extensions, a zatim zamenite YOUR_UPLOAD_ONLY_KEY u fajlu događaja šablona proširenja svojim pravim ključem samo za otpremanje.

Preuzmite za phpBB

SMF (Simple Machines Forum)

Pravi SMF paket - instalirajte preko Admin > Package Manager, a zatim zamenite YOUR_UPLOAD_ONLY_KEY u Sources/yis_forumupload.php svojim pravim ključem samo za otpremanje.

Preuzmite za SMF

MyBB

Pravi MyBB 1.8 dodatak. Kopirajte u inc/plugins/, aktivirajte u Configuration > Plugins, a zatim zamenite YOUR_UPLOAD_ONLY_KEY u fajlu dodatka svojim pravim ključem samo za otpremanje.

Preuzmite za MyBB

FluxBB, PunBB i ZetaBoards

Oni nemaju formalan sistem dodataka, pa je to mali isečak koda koji se lepi direktno u vaš šablon (FluxBB/PunBB) ili Admin CP (ZetaBoards) - kompletna uputstva za kopiranje za svaki:

Uputstvo za FluxBB Uputstvo za PunBB Uputstvo za ZetaBoards

WordPress dodatak

Prebacite svoju biblioteku medija (Media Library) na YourImageShare umesto na lokalni disk. Nova otpremanja slika/videa automatski idu preko istog /api endpointa opisanog iznad, lokalni fajl (i svaka generisana veličina sličice) briše se čim se otpremanje potvrdi, a svaki URL WordPress priloga - blok editor, istaknute slike, galerije, REST API - vodi na fajl hostovan na YourImageShare. Bez shortcode-a, bez promene načina rada.

• Prebacivanje cele postojeće biblioteke medija u pozadini (ili pomoću wp yis offload --all), ne samo novih otpremanja
• Slike i video snimci već ubačeni u objave nastavljaju da rade nakon uklanjanja lokalnih fajlova
• Sličice i srcset koriste našu sličicu od 280px, pa mala mesta za slike ne učitavaju fajlove pune veličine
• Fajlovi do 200MB, slati u delovima da veliki video snimci nikada ne opterete deljeni hosting
• Vratite bilo koji prebačeni fajl nazad na lokalno skladište u bilo kom trenutku
• Kolona u biblioteci medija pokazuje šta je prebačeno, a šta je još lokalno
• Prebačeni fajlovi se čuvaju kao private: učitavaju se gde god ih vaš sajt koristi, ali nemaju sopstvenu stranicu na YourImageShare

Preuzmite sa WordPress.org Preuzmite ZIP

U WordPress-u: Plugins > Add New, potražite YourImageShare Media Offload, a zatim Install i Activate.

Dugme za otpremanje za bilo koji sajt

Dajte posetiocima dugme "Otpremi" na bilo kom sajtu - formi za komentare, stranici podrške, forumu za koji nemamo dodatak, statičkom sajtu. Nalepite dva reda; nalog i serverski kod nisu potrebni.

<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 atributa su opciona: bez njih dugme prikazuje linkove sa dugmetom Kopiraj. Okvir za otpremanje gradi se oko linka.

• Otpremanje se dešava direktno na vašoj stranici: kliknite na dugme, prevucite fajlove na njega ili nalepite snimak ekrana - više fajlova odjednom, sa trakom napretka i sličicom
• Slike nalepljene ili prevučene direktno u polje navedeno u data-target (bilo koji textarea, input ili polje za uređivanje) se takođe otpremaju, a linkovi se dodaju u to polje; bez cilja prikazuju se ispod dugmeta sa dugmetom Kopiraj
• data-format: url (direktan link do fajla, podrazumevano), page, bbcode, html ili markdown; data-label menja tekst dugmeta
• data-key (opciono): vaš ključ samo za otpremanje (Moj nalog > API). Otpremanja tada idu na vaš nalog pod vašim ograničenjima. Bez ključa, otpremanja su anonimna i unlisted, sa dnevnim ograničenjem po posetiocu i po sajtu
• Programeri mogu da slušaju događaj yis:upload na okviru za otpremanje: event.detail.item sadrži {id, type, page, url, thumb}
• Fajlovi do 95 MB preko dugmeta (veći na sajtu). Naša moderacija i uslovi važe kao i uvek; svaki posetilac dobija sopstveni link za brisanje

Dugme se crta u sopstvenom izolovanom okviru, pa ga CSS vašeg sajta ne može pokvariti. Mali link "Image and video hosting by YourImageShare" ostaje vidljiv unutar okvira za otpremanje.

Prečica za iPhone i iPad

Otpremajte iz menija za deljenje bilo koje aplikacije - Photos, Files, Safari, snimka ekrana - i dobijte link u clipboard-u. Bez aplikacije za instalaciju i bez naloga.

Da je sami napravite u aplikaciji Shortcuts (oko dva minuta):

1. Nova prečica, nazovite je "Upload to YourImageShare". U njenim detaljima uključite Show in Share Sheet i prihvatite slike i medije.
2. Dodajte Get Contents of URL: URL https://yourimageshare.com/api/widget, metod POST, telo zahteva Form sa dva polja: uploads (File) = Shortcut Input, i client (Text) = ios-shortcut.
3. Dodajte Get Dictionary Value za data, pa još jedan za src - to je direktan link.
4. Dodajte Copy to Clipboard i Show Notification ("Link copied").

Bez ključa, otpremanja su anonimna i unlisted, sa dnevnim ograničenjem. Dodajte zaglavlje X-API-Key sa svojim ključem samo za otpremanje (Moj nalog > API) da otpremate na svoj nalog. Odgovor sadrži i delete_url ako želite da sačuvate link za brisanje.

PicGo i PicList

PicGo i PicList otpremaju nalepljene ili prevučene slike za Markdown uređivače - Typora, VS Code, Obsidian, Joplin - i stavljaju link u vaš tekst. Naš dodatak čini YourImageShare jednim od njihovih hostinga slika.

• U PicGo-u ili PicList-u: Plugins, potražite yourimageshare, instalirajte, pa izaberite YourImageShare kao uploader. Komandna linija: picgo install yourimageshare
• Ili preuzmite dodatak i uvezite ga kao lokalni dodatak (prvo raspakujte)
• Podešavanja: ključ samo za otpremanje (opciono - prazno = anonimna, unlisted otpremanja), vidljivost i da li da vraća direktan link slike (za Markdown) ili link stranice
• Link koji vraća nastavlja da radi kada se velike slike kasnije optimizuju u WebP

Preuzmite PicGo dodatak

Telegram bot

Dobijte link za fotografiju, video ili GIF bez napuštanja Telegrama. Pošaljite ga @YourImageShare_bot-u i link stiže odmah - bez naloga i bez API ključa. Bot otprema preko istog /api endpointa opisanog iznad.

• Pošaljite fotografiju, video, GIF ili fajl slike ili videa; album do 10 stiže u jednom odgovoru
• U grupi odgovorite sa /link na fotografiju ili video i bot objavljuje njegov link za sve
• /autodelete čini da se vaša sledeća otpremanja sama brišu nakon 1 sata, 1 dana, 1 nedelje ili 30 dana
• Svaki rezultat ima dugme Delete koje radi samo za osobu koja je otpremila fajl
• Linkovi su unlisted: fajl mogu videti samo ljudi koji imaju link
• Bot odgovara na jeziku vašeg Telegrama kada je sajt dostupan na njemu

Otvorite @YourImageShare_bot u Telegramu

Discord bot

Pretvorite bilo koju sliku, GIF ili video iz Discord-a u trajni link. Discord-ovi linkovi priloga posle nekog vremena prestaju da rade; YourImageShare linkovi ne prestaju. Bez naloga i bez API ključa. Bot otprema preko istog /api endpointa opisanog iznad.

• /upload sa fajlom: opciono automatsko brisanje nakon 1, 7 ili 30 dana, i only_me da link vidite samo vi
• Desni klik na poruku → Apps → Rehost on YourImageShare da prebacite do 6 slika ili videa iz nje u jednom odgovoru
• Dodajte ga na server ili na svoj nalog da ga koristite u bilo kom četu ili DM-u
• Svaki rezultat ima dugme Delete koje radi samo za osobu koja je otpremila fajl
• Linkovi su unlisted: fajl mogu videti samo ljudi koji imaju link

Dodajte YourImageShare u Discord

GitHub Action za Playwright i Cypress

Kada end-to-end testovi padnu u pull requestu, vidite zašto bez preuzimanja zip arhiva artefakata. Action otprema snimke ekrana grešaka i vizuelne razlike i prikazuje ih kao slike u jednom komentaru pull requesta, koji se ažurira pri svakom pokretanju.

• Radi sa Playwright-om i Cypress-om, i sam utvrđuje koji projekat koristi
• Neuspela vizuelna poređenja prikazuju se kao Expected, Actual i Diff, sa linkom do klizača pre/posle (Playwright-ov toHaveScreenshot; za Cypress dodaci cypress-image-diff-js i cypress-visual-regression)
• Komentar se menja u "all tests passed" čim se testovi isprave; isti izveštaj ide u rezime posla
• Snimci ekrana su privatni (samo fajlovi slika, bez stranice) i podrazumevano se brišu nakon 30 dana
• Potreban je vaš ključ samo za otpremanje kao tajna repozitorijuma YOURIMAGESHARE_API_KEY; nikada ne obara vaš build

- uses: yourimageshare/playwright-pr-screenshots@v1
  if: always()
  with:
    api-key: ${{ secrets.YOURIMAGESHARE_API_KEY }}

Uputstvo za podešavanje na GitHub-u

Projekti zajednice

Neke od najboljih YourImageShare integracija prave ljudi koji ga koriste. Ove projekte su napravili članovi zajednice pomoću javnog API-ja opisanog iznad. Održavaju ih njihovi autori, pa za pitanja ili prijave grešaka kontaktirajte autora preko stranice projekta.

• YourImageShare Uploads for FlatBB - dodatak za FlatBB forum autora madromas (MadWay Inc.).
  • Dodaje dugme za otpremanje u FlatBB uređivač objava: izaberite jednu ili više slika ili videa i Markdown se ubacuje na mesto kursora
  • Ubacuje svako otpremanje kao sličicu na koju se može kliknuti, sliku pune veličine ili običan link (video kao link)
  • Otpremanja idu preko servera vašeg foruma sa API ključem samo za otpremanje, pa ključ nikada ne stiže u pregledače posetilaca
  • Fajlovi se hostuju na YourImageShare, a ne na disku vašeg foruma, sa podrazumevanom vidljivošću koju vi birate (private, unlisted ili public)
  • Radi uz FlatBB-ov sopstveni uploader, sa posebnim ograničenjem veličine fajla

  Izvorni kod na GitHub-u · Stranica na FlatBB Marketplace-u

Sa bloga