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şturduğunuzda eskisi hemen geçersiz olur; bu yüzden düğmeye basmadan önce anahtarı kullandığınız her yeri güncellemeye hazır olun.

Aynı sekmede ikinci, bağımsız bir Yalnızca yükleme anahtarı da bulunur. 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ı başlık olarak gönderin. Bu yöntem tercih edilir, çünkü sorgu dizeleri erişim günlüklerinde, proxy günlüklerinde ve Referer başlıklarında kalabilir:

X-API-Key: YOUR_API_KEY

?key= sorgu parametresi de çalışır; eski entegrasyonlarla uyumluluk ve hızlı, tek seferlik curl komutları için korunmuştur. İkisi birlikte varsa başlık geçerli olur.

?key=YOUR_API_KEY

Uç Noktalar

Yükleme, listeleme ve silme aynı kimlik doğrulamayı ve istek sınırlamasını 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 daha büyük JPEG/PNG resimler, dosya boyutunu belirgin biçimde küçülttüğünde yüklemeden kısa süre sonra WebP'ye dönüştürülür. Maksimum boyut: 200MB; çok büyük 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) veya 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 POST /api/chunk (multipart/form-data) gönderin. Yanıt {"type": "success", "chunk_size": 5242880} olur.
3. uploads yerine upload_id ve filename ile, ayrıca 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 bitiren POST /api isteği sayılır.

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

GET, yüklemelerinizden birini aşağıdaki listeyle aynı alanlarla döndürür. PATCH ise visibility, title veya description değerini değiştirir (form alanları veya JSON; boş bir 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ği, sayfası ve tüm bağlantıları korunur. İ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üklemeyle 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ülenme 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 düzenleyici 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ı bağlantılardır). Henüz tek bir "yüklemeyi getir" uç noktası yoktur; bu yüzden bir dosyanın id değerini sonradan öğrenmenin yolu da bu listedir.

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 uç noktalarının 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 (hiç size ait olmamıştır veya zaten silinmiştir) 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 fazla anahtarı dönüşümlü kullanmasına karşı güvenlik önlemi olarak IP başına daha kaba bir günlük üst sınır bulunur. Yükleme, listeleme ve silme aynı limitleri paylaşır.

Bu limitler değişebilir. Her yanıt standart istek limiti başlıklarını içerir:

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

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

Hatalar

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

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

İstemci Kitaplıkları

Yukarıdaki uç noktaları saran, türlendirilmiş sonuçlar sunan ve ham HTTP işlemek yerine API hatalarında istisna fırlatan 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 bulunur - 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ı getirmez, ayrıca 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 paketi), netstandard2.0 hedefler; böylece hem .NET Framework hem de modern .NET ile ç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+. {:ok, result}| {:error, reason} etiketli demetlerini döndürür; bu, diğer tüm SDK'lardaki bu API'nin hata işleme biçiminin doğrudan karşılığıdır. Ayrıca istisna fırlatan ünlemli varyantlar da vardır. Kaynak kod GitHub'da, belgeler HexDocs'ta.

{:yourimageshare, "~> 1.1"}

MCP Sunucusu

Yapay zeka kodlama ajanları için (Claude Code, Cursor ve diğer MCP-uyumlu araçlar): bir hata raporuna, PR açıklamasına veya destek konuşmasına ekran görüntüsünü base64 blobu ya da elle yükleme adımı yerine gerçek bir URL olarak ekleyin. Claude Desktop ve diğer tüm MCP istemcileriyle 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 bağlantı, 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 kuruyorsa işinize yarar.

MCP'ye yeni misiniz? Adım adım kurulum için Claude ve ChatGPT'yi bu API'ye MCP üzerinden bağlama rehberine 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üklemeye gerek kalmadan doğrudan YourImageShare'e göndermek için bir tarayıcı eklentisi ile hazır yapılandırmalar ve betikler. Her biri yukarıda belgelenen aynı /api uç noktası üzerinden yükleme yapar.

Tarayıcı Eklentisi (Chrome & Firefox)

Chrome ve Firefox için YourImageShare Capture eklentisi betik ve yapılandırma dosyalarına hiç gerek bırakmaz. Görünen alanı, sürükleyerek seçilen bir bölgeyi veya kaydırmalı tam sayfayı yakalar; oklar, metin, bulanıklaştırma/gizleme ve diğer notlar için yerleşik bir düzenleyici açar, ardından sonucu indirir, panonuza kopyalar veya tek tıkla doğrudan YourImageShare'e yayınlar. Yayınlama, yukarıda belgelenen aynı /api uç noktasını kullanır: API anahtarınızı eklentinin Ayarlar bölümüne bir kez ekleyin; bundan sonra her yayınlama anında 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.

Firefox için YourImageShare Capture'ı edinin Chrome için YourImageShare Capture'ı 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 yerine gerçek anahtarınızı yazın. Bunu resim/dosya hedefiniz olarak ayarlayın; yakalamalar 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. Bunu masaüstü ortamınızda Flameshot'ın varsayılan kısayolu yerine bir klavye kısayoluna atayı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 birlikte 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 gönderi düzenleyicisinin yanına gerçek bir "Resim Yükle" düğmesi ekleyin. Her biri yukarıda belgelenen aynı /api uç noktası üzerinden yükler ve imlecinizin olduğu yere BBCode ekler; ayrı sekme ve elle kopyala-yapıştır yok.

Forum yüklemeleri varsayılan olarak private olur: resim gönderide çalışır, ancak YourImageShare ona kendi sayfasını vermez (yorum, tepki veya reklam yok). Bağlantıya sahip herkes için bir sayfa da isterseniz, her eklentide unlisted seçeneğine geçmek için bir ayar vardır.

phpBB

Gerçek bir phpBB 3.2/3.3 uzantısı. ext/ klasörüne açın, Customise > Manage extensions altında etkinleştirin, ardından uzantının şablon olay dosyasındaki YOUR_UPLOAD_ONLY_KEY yerine gerçek yalnızca yükleme anahtarınızı yazın.

phpBB için indirin

SMF (Simple Machines Forum)

Gerçek bir SMF paketi: Admin > Package Manager ile kurun, ardından Sources/yis_forumupload.php dosyasındaki YOUR_UPLOAD_ONLY_KEY yerine gerçek yalnızca yükleme anahtarınızı yazın.

SMF için indirin

MyBB

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

MyBB için indirin

FluxBB, PunBB & ZetaBoards

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

FluxBB talimatları PunBB talimatları ZetaBoards talimatları

WordPress Eklentisi

Medya Kütüphanenizi yerel disk yerine YourImageShare'e aktarın. Yeni resim/video yüklemeleri otomatik olarak yukarıda belgelenen aynı /api uç noktasından geçer, yükleme onaylandıktan sonra yerel dosya (ve oluşturulan her küçük resim boyutu) silinir ve blok düzenleyici, öne çıkan görseller, galeriler, REST API dahil her WordPress ek URL'si YourImageShare'de barındırılan dosyaya yönlenir. Kısa kod yok, iş akışı değişikliği yok.

• Mevcut bir Medya Kütüphanesini yalnızca yeni yüklemeleri değil, arka planda (veya wp yis offload --all ile) toplu olarak aktarın
• Yazılara eklenmiş 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öylece büyük videolar paylaşımlı sunucuyu zorlamaz
• Aktarılan herhangi bir dosyayı istediğiniz zaman yerel depolamaya geri yükleyin
• Medya Kütüphanesi sütunu, nelerin aktarıldığını ve nelerin hâlâ yerel olduğunu gösterir
• Aktarılan dosyalar private olarak saklanır: sitenizin kullandığı her yerde yüklenir, ancak YourImageShare üzerinde kendi sayfaları olmaz

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

WordPress'te: Plugins > Add New yolunu izleyin, YourImageShare Media Offload araması yapın, ardından Install ve Activate'e tıklayın.

Blogdan