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.
| Parametre | Tip | Açıklama |
|---|---|---|
images[] | file | Zorunlu. JPG, PNG, WebP, GIF |
expiry_days | int | 0 = 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": "",
"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ı
| HTTP | Anlam |
|---|---|
400 | Geçersiz dosya / limit aşımı |
401 | API anahtarı yok veya geçersiz |
403 | CSRF / yetki hatası (web yükleme) |
404 | Görsel bulunamadı |