API Docs

HemenResim API

Görselleri programatik olarak yükleyin, bilgi alın ve uygulamalarınıza entegre edin.

Base URL: https://www.hemenresim.com

Kimlik doğrulama

Tüm yazma isteklerinde API anahtarınızı gönderin:

X-API-Key: YOUR_API_KEY

Alternatif: api_key query/body parametresi.

API anahtarı görmek için giriş yapın veya üye olun.

Görsel yükleme

POST /api/upload

multipart/form-data ile en fazla 5 görsel gönderin.

ParametreTipAçıklama
images[]fileZorunlu. JPG, PNG, WebP, GIF
expiry_daysint0 = süresiz, 1 / 7 / 30 / 90

Başarılı yanıt

{
  "ok": true,
  "images": [
    {
      "slug": "a1b2c3d4e5f6",
      "url": "https://www.hemenresim.com/gorsel/SLUG",
      "direct": "https://www.hemenresim.com/i/SLUG",
      "html": "<a href=\"...\"><img src=\"...\"></a>",
      "bbcode": "[url=...][img]...[/img][/url]",
      "markdown": "![name](direct)",
      "delete": "https://www.hemenresim.com/sil/TOKEN",
      "width": 1200,
      "height": 800,
      "size": 184220
    }
  ]
}

Görsel bilgisi

GET /api/info/{slug}

Herkese açık. Süresi dolmamış görseller için meta veri döner.

{
  "ok": true,
  "slug": "a1b2c3d4e5f6",
  "name": "photo.jpg",
  "width": 1200,
  "height": 800,
  "size": 184220,
  "mime": "image/webp",
  "views": 12,
  "url": "...",
  "direct": "...",
  "created_at": "2026-08-11 12:00:00",
  "expires_at": null
}

Örnekler

Hata kodları

HTTPAnlam
400Geçersiz dosya / limit aşımı
401API anahtarı yok veya geçersiz
403CSRF / yetki hatası (web yükleme)
404Görsel bulunamadı