API Dokümantasyonu

API Anahtarı Alma

Giriş yapın, Hesabım sayfasına gidin ve API sekmesini açın. Anahtarınız burada, yanında bir Yeniden oluştur düğmesiyle birlikte görünür. Anahtarı yeniden oluşturmak eskisini hemen geçersiz kılar; bu yüzden düğmeye basmadan önce kullanıldığı her yeri güncelleyin.

Bu sekmede ikinci, bağımsız bir Yalnızca yükleme anahtarı da vardır. Ne zaman kullanmanız gerektiği için aşağıdaki ipucuna ve Forum Eklentileri bölümüne bakın.

Kimlik Doğrulama

Anahtarınızı üstbilgi (header) olarak gönderin. Sorgu dizeleri erişim günlüklerinde, proxy günlüklerinde ve Referer üstbilgilerinde görünebildiği için bu yöntem tercih edilir:

X-API-Key: YOUR_API_KEY

?key= sorgu parametresi de çalışır; eski entegrasyonlarla uyumluluk ve hızlı, tek seferlik curl komutları için bırakılmıştır. İkisi birlikte varsa üstbilgi geçerli olur.

?key=YOUR_API_KEY

Endpoint'ler

Yükleme, listeleme ve silme aynı kimlik doğrulamayı ve istek limitini paylaşır; büyük dosyalar önce parçalar halinde gönderilebilir.

POST /api - Dosya Yükleme

Kimliği doğrulanmış hesap için tek bir dosya yükler.

Kabul edilen türler: JPG, PNG, GIF, WEBP, AVIF, BMP, TIFF, HEIC veya HEIF resimler; MP4, WEBM veya AVI video (kesin liste zamanla genişleyebilir). HEIC/HEIF ve TIFF dosyaları WebP olarak saklanır, MP4/WebM dışındaki videolar MP4'e dönüştürülür ve büyük JPEG/PNG resimler, dosyayı belirgin şekilde küçülttüğünde yüklemeden kısa süre sonra WebP'ye dönüştürülür. En büyük boyut: 200MB; boyutu aşan veya okunamayan dosyalar 422 ile reddedilir.

Yanıt - 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 - Büyük Dosyalar

Tek bir istek en fazla 100MB taşıyabilir. Daha büyük dosyalar için (en fazla 200MB) ya da yavaş bir bağlantıda her isteği küçük tutmak için dosyayı en fazla 5MB'lık parçalar halinde gönderin, ardından POST /api ile bitirin:

1. Bir yükleme kimliği seçin: 32 rastgele onaltılık karakter.
2. Her parça için upload_id, index (0'dan başlar), total (parça sayısı) ve chunk içinde baytlarla birlikte POST /api/chunk (multipart/form-data) gönderin. Yanıt {"type": "success", "chunk_size": 5242880} şeklindedir.
3. uploads yerine upload_id ve filename ile, gerekirse diğer yükleme alanlarıyla birlikte POST /api gönderin. Yanıt, normal yükleme yanıtıdır.

Tamamlanmamış bir yüklemenin parçaları 2 saat sonra silinir. Yükleme istek limitlerine yalnızca bitirme isteği olan POST /api sayılır.

GET /api/{id} ve PATCH /api/{id} - Tek Yükleme

GET, yüklemelerinizden birini aşağıdaki liste ile aynı alanlarla döndürür. PATCH ise visibility, title veya description değerini değiştirir (form alanları veya JSON; boş başlık ya da açıklama alanı temizler) ve güncellenmiş yüklemeyi yanıtlar. İkisi de tam API anahtarı gerektirir; hesabınızda böyle bir yükleme yoksa 404 döner.

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 - Dosyayı Değiştirme

Yüklemelerinizden birinin arkasındaki dosyayı değiştirir; kimliğini, sayfasını ve tüm linklerini korur. İzin verilen her tür çalışır, farklı bir tür bile olabilir (bir resim video olabilir). Yeni dosyayı uploads olarak (veya POST /api/chunk ile parçalar halinde gönderilmiş bir dosyanın upload_id değeriyle) gönderin; keep_original yüklemedeki gibi çalışır. Yeni dosya, yeni bir yükleme ile aynı kontrollerden ve dönüşümlerden geçer ve önceki sürüm kaldırılır. Tam API anahtarı gerektirir; hesabınızda böyle bir yükleme yoksa 404, parola korumalı veya görüntüleme sınırlıysa 409 döner.

curl -X POST https://yourimageshare.com/api/aB3xY9qRz1/replace \
  -H "X-API-Key: YOUR_API_KEY" -F [email protected]

GET /api - Yüklemelerinizi Listeleme

Kimliği doğrulanmış hesabın yüklemelerinin (API, web sitesi veya editör gibi herhangi bir kaynaktan) sayfalanmış bir listesini, en yeniden başlayarak ve sayfa başına 50 olarak döndürür.

Yanıt - 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 }
}

Alanlar burada, yukarıdaki yükleme yanıtındakiyle aynı anlama gelir (parola korumalı bir yüklemede path ve thumb kısa ömürlü imzalı linklerdir). Henüz tek bir "yüklemeyi getir" endpoint'i yok; bu yüzden bu liste, bir dosyanın id değerini sonradan bulmanın da yoludur.

DELETE /api/{id} - Yüklemeyi Silme

Kimliği doğrulanmış hesabın yüklemelerinden birini kalıcı olarak siler. Bu işlem API üzerinden geri alınamaz. {id}, yükleme veya liste endpoint'lerinin id olarak döndürdüğü değerdir.

Yanıt - 200 OK:

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

Hesabınızda bu kimliğe sahip bir yükleme yoksa (ya size ait değildi ya da zaten silinmiş) 404 döner.

İstek Limitleri

Her API anahtarının dakikalık ve günlük bağımsız kotaları vardır; ayrıca tek bir IP'nin birden çok anahtarı sırayla kullanmasına karşı bir güvence olarak daha geniş bir IP başına günlük üst sınır bulunur. Yükleme, listeleme ve silme istekleri aynı limitleri paylaşır.

Bu limitler değişebilir. Her yanıt standart istek limiti üstbilgilerini içerir:

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

Bir limit aşıldığında 429 döner; Retry-After üstbilgisi kaç saniye beklemeniz gerektiğini söyler.

Hatalar

Her hata yanıtı, endpoint veya nedenden bağımsız olarak aynı yapıyı kullanır:

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

İstemci Kütüphaneleri

Yukarıdaki endpoint'leri tür tanımlı sonuçlarla saran ve ham HTTP ile uğraşmak yerine API hatalarında istisna oluşturan resmi SDK'lar.

JavaScript / TypeScript

Sıfır bağımlılık, Node.js ve tarayıcılarda çalışır. Ayrıca JSR üzerinde @yourimageshare/yourimageshare adıyla da var - npx jsr add @yourimageshare/yourimageshare - aynı kaynak, doğrudan TypeScript olarak yayımlanır.

npm install yourimageshare

Python

Tek bağımlılık (requests), Python 3.8+.

pip install yourimageshare

PHP

Sıfır Composer bağımlılığı (PHP'nin kendi curl eklentisini kullanır), PHP 7.4+. Kaynak kod GitHub'da.

composer require yourimageshare/yourimageshare-php

Go

Sıfır bağımlılık (yalnızca standart kütüphane), Go 1.18+. Tam başvuru belgeleri için pkg.go.dev adresine bakın.

go get github.com/yourimageshare/yourimageshare/go

Rust

İki bağımlılık (engelleyici HTTP için ureq; asenkron çalışma zamanı eklenmez - ve serde), Rust 1.70+. Kaynak kod GitHub'da.

cargo add yourimageshare

Ruby

Sıfır gem bağımlılığı (standart kütüphane Net::HTTP + json), Ruby 2.7+. Kaynak kod GitHub'da.

gem install yourimageshare

.NET

Tek bağımlılık (Microsoft'un kendi System.Text.Json kütüphanesi), netstandard2.0'ı hedefler; böylece hem .NET Framework hem de modern .NET'ten çalışır. Kaynak kod GitHub'da. Bu canlı API'ye karşı geliştirildi ve doğrulandı; NuGet'te yakında yayımlanacak.

dotnet add package YourImageShare

Dart / Flutter

Tek bağımlılık (http, Dart ekibinin kendi paketi), Dart 2.17+. Kaynak kod GitHub'da. Bu canlı API'ye karşı geliştirildi ve doğrulandı; pub.dev'de yakında yayımlanacak.

dart pub add yourimageshare

Elixir

Tek bağımlılık (Req), Elixir 1.14+. Etiketli {:ok, result}| {:error, reason} demetleri döndürür; bu, diğer tüm SDK'lardaki bu API hata yönetiminin doğrudan karşılığıdır. İstisna fırlatan ünlemli sürümler de vardır. Kaynak kod GitHub'da, belgeler HexDocs'ta.

{:yourimageshare, "~> 1.1"}

MCP Sunucusu

Yapay zekâ kodlama ajanları için (Claude Code, Cursor ve diğer MCP uyumlu araçlar). Bir ekran görüntüsünü hata raporuna, PR açıklamasına veya destek yazışmasına base64 yığını ya da elle yükleme adımı yerine gerçek bir URL olarak ekleyin. Claude Desktop ve diğer MCP istemcilerinde de aynı şekilde çalışır. Kurulum gerektirmeden doğrudan npx ile çalıştırın:

npx yourimageshare-mcp

Araçlar: upload_image (yerel bir dosya, satır içi içerik veya bir link, en fazla 200MB, isteğe bağlı görünürlük, başlık ve otomatik silme ile), list_uploads, get_upload, update_upload ve delete_upload.

Ayrıca resmi MCP Registry'de (io.github.yourimageshare/yourimageshare adıyla) ve Smithery ile Glama'da listelenir; MCP istemciniz bunlardan birinden kurulum yapıyorsa.

MCP'ye yeni misiniz? Adım adım kurulum için Claude ve ChatGPT'yi MCP üzerinden bu API'ye nasıl bağlarsınız yazısına bakın.

Kod Örnekleri

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)

Yukarıdaki resmi Go SDK'sı bunu sizin için sarmalar; bu ham sürüm, bağımlılık eklemek istemeyenler için burada.

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
}

Ekran Görüntüsü Araçları

Ekran görüntülerini elle yüklemeden doğrudan YourImageShare'e göndermek için bir tarayıcı eklentisi, hazır yapılandırmalar ve komut dosyaları. Her biri yukarıda anlatılan aynı /api endpoint'i üzerinden yükleme yapar.

Tarayıcı Eklentisi (Chrome & Firefox)

Chrome ve Firefox için YourImageShare Capture eklentisi, komut dosyalarına ve yapılandırma dosyalarına hiç gerek bırakmaz. Görünen alanı, fareyle seçtiğiniz bir bölgeyi veya kaydırmalı tüm sayfayı yakalar, ok, metin, bulanıklaştırma/gizleme ve diğer notlar için yerleşik bir editör açar; sonra sonucu indirir, panonuza kopyalar veya tek tıkla doğrudan YourImageShare'de yayınlar. Yayınlama, yukarıda anlatılan aynı /api endpoint'ini kullanır. API anahtarınızı eklentinin Ayarlar bölümüne bir kez ekleyin; bundan sonraki her yayın hemen paylaşılabilir bir link döndürür. Masaüstü Chrome'da (ve diğer Chromium tarayıcılarında), masaüstü Firefox'ta ve Android için Firefox'ta çalışır.

YourImageShare Capture'ı Firefox için edinin YourImageShare Capture'ı Chrome için edinin

ShareX

Aşağıdaki özel yükleyiciyi indirin, ardından ShareX'te Destinations > Custom uploader settings > Import > from file yolunu izleyin, indirdiğiniz .sxcu dosyasını açın ve Headers alanındaki YOUR_API_KEY değerini gerçek anahtarınızla değiştirin. Bunu resim/dosya hedefiniz olarak ayarlayın; yakaladıklarınız otomatik yüklenir.

YourImageShare.sxcu dosyasını indirin

Flameshot (Linux)

flameshot gui komutunu çalıştıran, yakalamayı yükleyen ve linki panonuza kopyalayan küçük bir kabuk betiği. Flameshot'ın varsayılan kısayolu yerine masaüstü ortamınızda bir klavye kısayoluna bağlayın.

yis-flameshot-upload.sh dosyasını indirin

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

Greenshot'ın yerleşik External command hedefi için bir PowerShell betiği. Windows ile gelen Windows PowerShell 5.1 ile uyumludur, ek kurulum gerekmez.

yis-greenshot-upload.ps1 dosyasını indirin

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

Forum Eklentileri

Forumunuzun mesaj editörünün yanına gerçek bir "Resim Yükle" düğmesi ekleyin. Her biri yukarıda anlatılan aynı /api endpoint'i üzerinden yükleme yapar ve imlecinizin olduğu yere BBCode ekler; ayrı sekme ve elle kopyala-yapıştır yok.

Forum yüklemeleri varsayılan olarak private'tır: resim gönderide çalışır, ancak YourImageShare ona kendi sayfasını vermez (yorum, tepki veya reklam yok). Her eklentide, linke sahip herkes için bir sayfa da istiyorsanız unlisted değerine geçmek için bir ayar bulunur.

phpBB

Gerçek bir phpBB 3.2/3.3 uzantısı. ext/ klasörüne çıkarın, Customise > Manage extensions altından etkinleştirin, ardından uzantının şablon olay dosyasındaki YOUR_UPLOAD_ONLY_KEY değerini gerçek yalnızca yükleme anahtarınızla değiştirin.

phpBB için indirin

SMF (Simple Machines Forum)

Gerçek bir SMF paketi. Admin > Package Manager üzerinden kurun, ardından Sources/yis_forumupload.php dosyasındaki YOUR_UPLOAD_ONLY_KEY değerini gerçek yalnızca yükleme anahtarınızla değiştirin.

SMF için indirin

MyBB

Gerçek bir MyBB 1.8 eklentisi. inc/plugins/ klasörüne kopyalayın, Configuration > Plugins altından etkinleştirin, ardından eklenti dosyasındaki YOUR_UPLOAD_ONLY_KEY değerini gerçek yalnızca yükleme anahtarınızla değiştirin.

MyBB için indirin

FluxBB, PunBB & ZetaBoards

Bunların resmi bir eklenti sistemi yoktur; bu yüzden şablonunuza (FluxBB/PunBB) veya Yönetim Paneli'ne (ZetaBoards) doğrudan yapıştırılan küçük bir kod parçasıdır. Her biri için tam kopyala-yapıştır talimatları:

FluxBB talimatları PunBB talimatları ZetaBoards talimatları

WordPress Eklentisi

Medya Kitaplığınızı yerel disk yerine YourImageShare'e taşıyın. Yeni resim/video yüklemeleri yukarıda anlatılan aynı /api endpoint'inden otomatik olarak geçer, yükleme onaylandığında yerel dosya (ve oluşturulan her küçük resim boyutu) silinir ve her WordPress ek URL'si (blok editörü, öne çıkan görseller, galeriler, REST API) YourImageShare'de barındırılan dosyaya çözülür. Kısa kod yok, iş akışı değişikliği yok.

• Mevcut bir Medya Kitaplığını yalnızca yeni yüklemeleri değil, arka planda (veya wp yis offload --all ile) toplu olarak taşıyın
• Yazılara yerleştirilmiş resim ve videolar, yerel dosyaları kaldırıldıktan sonra da çalışmaya devam eder
• Küçük resimler ve srcset 280px'lik küçük resmimizi kullanır; böylece küçük resim alanları tam boyutlu dosyaları yüklemez
• 200MB'a kadar dosyalar, parçalar halinde gönderilir; büyük videolar paylaşımlı sunucuyu hiç zorlamaz
• Taşınan herhangi bir dosyayı istediğiniz zaman yerel depolamaya geri alın
• Medya Kitaplığı sütunu, neyin taşındığını ve neyin hâlâ yerel olduğunu gösterir
• Taşınan dosyalar private olarak saklanır: sitenizin kullandığı her yerde yüklenir, ancak YourImageShare'de kendi sayfaları olmaz

WordPress.org'dan edinin ZIP dosyasını indirin

WordPress'te: Eklentiler > Yeni Ekle yolunu izleyin, YourImageShare Media Offload araması yapın, ardından Yükleyin ve Etkinleştirin.

Telegram Botu

Telegram'dan çıkmadan bir fotoğraf, video veya GIF için link alın. Dosyayı @YourImageShare_bot'a gönderin, link hemen geri gelir; hesap ve API anahtarı gerekmez. Bot, yukarıda anlatılan aynı /api endpoint'i üzerinden yükleme yapar.

• Bir fotoğraf, video, GIF veya resim ya da video dosyası gönderin; 10'a kadar öğeden oluşan bir albüm tek yanıtta geri gelir
• Bir grupta, bir fotoğrafı veya videoyu /link ile yanıtlayın; bot linkini herkes için paylaşır
• /autodelete, sonraki yüklemelerinizin 1 saat, 1 gün, 1 hafta veya 30 gün sonra kendiliğinden silinmesini sağlar
• Her sonuçta, yalnızca dosyayı yükleyen kişi için çalışan bir Sil düğmesi bulunur
• Linkler listelenmez: dosyayı yalnızca linke sahip kişiler görebilir
• Site Telegram dilinizde mevcutsa bot sizi o dilde yanıtlar

@YourImageShare_bot'u Telegram'da açın

Blogdan