API dokumentacija

Dobijanje API ključa

Prijavite se, otvorite Moj nalog i idite na karticu API. Tu se prikazuje vaš ključ, zajedno sa dugmetom Generiši ponovo. Ponovnim generisanjem stari ključ odmah prestaje da važi, pa ga prvo zamenite svuda gde se koristi, pa tek onda kliknite.

Ista kartica sadrži i drugi, nezavisni ključ samo za otpremanje - pogledajte savet ispod i dodatke za forume da vidite kada ga treba koristiti umesto glavnog.

Autentifikacija

Pošaljite ključ kao zaglavlje - to je poželjan način, jer query stringovi često završe u pristupnim logovima, logovima proksija i Referer zaglavljima:

X-API-Key: YOUR_API_KEY

Radi i query parametar ?key=, koji je ostavljen zbog kompatibilnosti sa starijim integracijama i brzih jednokratnih curl komandi. Ako su prisutna oba, zaglavlje ima prednost.

?key=YOUR_API_KEY

Endpointi

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

POST /api - otpremanje fajla

Otprema jedan fajl za autentifikovani nalog.

Prihvaćeni tipovi: slike JPG, PNG, GIF, WEBP, AVIF, BMP, TIFF, HEIC ili HEIF; video MP4, WEBM ili AVI (tačan spisak može da se proširi tokom vremena). HEIC/HEIF i TIFF se čuvaju kao WebP, video koji nije MP4/WebM konvertuje se u MP4, a veće JPEG/PNG slike se konvertuju u WebP ubrzo nakon otpremanja kada ih to primetno smanjuje. Najveća 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 svaki zahtev ostane mali na sporoj vezi, pošaljite fajl u delovima do 5MB, a zatim završite sa POST /api:

1. Izaberite id otpremanja: 32 nasumična heksadecimalna znaka.
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 vaš fajl sa istim poljima kao u listi ispod. PATCH menja njegove 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 na vašem nalogu nema takvog fajla.

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

Menja fajl iza jednog vašeg otpremanja 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 preko POST /api/chunk); keep_original radi kao pri otpremanju. Novi fajl prolazi iste provere i konverzije kao novo otpremanje, a prethodna verzija se uklanja. Zahteva pun API ključ; 404 ako na vašem nalogu nema takvog fajla, 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 [email protected]

GET /api - lista vaših fajlova

Vraća listu fajlova autentifikovanog naloga po stranicama (iz bilo kog izvora - API, veb sajt ili uređivač), najnoviji prvi, 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 (kod fajla zaštićenog lozinkom, path i thumb su potpisani linkovi kratkog veka). Još uvek nema posebnog endpointa za jedan fajl, pa je ova lista ujedno način da naknadno pronađete id fajla.

DELETE /api/{id} - brisanje fajla

Trajno briše jedan fajl autentifikovanog naloga. Ovo se ne može poništiti preko API-ja. {id} je vrednost vraćena kao id iz endpointa za otpremanje ili listanje.

Odgovor - 200 OK:

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

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

Ograničenja

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čenjima:

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 gornje endpointe, vraćaju tipizirane rezultate i podižu izuzetke pri API greškama umesto sirovog rada sa HTTP-om.

JavaScript / TypeScript

Bez zavisnosti, radi u Node.js-u i pregledačima. Dostupno i 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 ekstenziju curl), PHP 7.4+. Izvorni kod na GitHub-u.

composer require yourimageshare/yourimageshare-php

Go

Bez zavisnosti (samo standardna biblioteka), Go 1.18+. Punu referentnu dokumentaciju pogledajte na pkg.go.dev.

go get github.com/yourimageshare/yourimageshare/go

Rust

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

cargo add yourimageshare

Ruby

Bez gem zavisnosti (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 na .NET Framework-u i na modernom .NET-u. Izvorni kod na GitHub-u. Izgrađeno i provereno na ovom živom API-ju; objava na NuGet uskoro.

dotnet add package YourImageShare

Dart / Flutter

Jedna zavisnost (http, paket Dart tima), Dart 2.17+. Izvorni kod na GitHub-u. Izgrađeno i provereno na ovom živom API-ju; objava 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 obrade grešaka ovog API-ja u svakom drugom SDK-u - plus varijante sa uzvičnikom koje podižu 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 podršku kao pravi link umesto base64 bloka ili ručnog otpremanja. Radi na isti način sa Claude Desktop-om i svakim drugim MCP klijentom. Pokrenite direktno pomoću npx, bez instalacije:

npx yourimageshare-mcp

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

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

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

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 radi 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 pravo 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, deo koji označite prevlačenjem ili celu stranicu sa skrolovanjem, otvara ugrađeni uređivač za strelice, tekst, zamućivanje/prekrivanje i druge oznake, a zatim preuzima rezultat, kopira ga u klipbord ili ga jednim klikom objavljuje pravo 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 svojim 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 klipbord. Povežite je sa prečicom na tastaturi u svom 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.

Forumska otpremanja 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 sa template događajima 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 formalni sistem dodataka, pa je to mali isečak koda koji se lepi direktno u vaš šablon (FluxBB/PunBB) ili Admin CP (ZetaBoards) - potpuna uputstva za kopiranje i lepljenje za svaki:

Uputstvo za FluxBB Uputstvo za PunBB Uputstvo za ZetaBoards

WordPress dodatak

Prebacite svoju 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 WordPress URL priloga - blok editor, istaknute slike, galerije, REST API - vodi na fajl hostovan na YourImageShare. Bez shortcode-a, bez promene načina rada.

• Grupno prebacivanje postojeće Media Library u pozadini (ili pomoću wp yis offload --all), a ne samo novih otpremanja
• Slike i video snimci već ubačeni u objave nastavljaju da rade i 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, šalju se u delovima pa veliki video snimci nikada ne opterećuju zajednički hosting
• Bilo koji prebačeni fajl možete u svakom trenutku vratiti na lokalno skladište
• Kolona u Media Library prikazuje šta je prebačeno, a šta je još lokalno
• Prebačeni fajlovi se čuvaju kao private: učitavaju se svuda gde 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, pa Install i Activate.

Sa bloga