API belgelendirmesi
API erişimi aktif Pro veya Premium aboneliği gerektirir. Bir API anahtarıyla kimlik doğrulayın, ardından Gösterge Panelinde gördüğünüz aynı kütüphaneye görsel yükleyin. Kotalar sitedeki ücretli planınızla eşleşir.
Görsel yükle
POST /api/v1/upload — multipart/form-data.
Parametreler
Authorization- Zorunlu. İstek başlığı. Biçim: Bearer API_ANAHTARINIZ.
file- Zorunlu. İkili bir dosya veya base64 verisi.
name- İsteğe bağlı. Dosya adı; yerel multipart yüklemede otomatik algılanır.
Örnek istek
İkili dosya
curl https://phototourl.com/api/v1/upload \ -X POST \ -H "Authorization: Bearer ptu_live_YOUR_KEY" \ -F "file=@./product.jpg"
Base64
curl https://phototourl.com/api/v1/upload \ -X POST \ -H "Authorization: Bearer ptu_live_YOUR_KEY" \ -F "file=R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7" \ -F "name=pixel.gif"
Yerel dosya yüklerken her zaman POST kullanın. GET desteklenmez.
Yanıt alanları
id- Kütüphanenizdeki kaynak id’si.
url- Ürün sayfalarında kullanabileceğiniz CDN URL.
fileName- Orijinal dosya adı.
fileSize- Dosya boyutu (bayt).
mimeType- Yüklenen dosyanın MIME türü.
createdAt- UTC’de yükleme zamanı, biçim YYYY-MM-DD HH:mm:ss.
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"url": "https://cdn.phototourl.com/pro/2026-11-05-a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpg",
"fileName": "product.jpg",
"fileSize": 128472,
"mimeType": "image/jpeg",
"createdAt": "2026-11-05 10:20:30"
}Görselleri listele
İsteğe bağlı page ve pageSize ile GET /api/v1/images (en fazla 100).
curl "https://phototourl.com/api/v1/images?page=1&pageSize=20" \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Yanıt alanları
resources- Görsel dizisi: id, fileName, url, fileSize, mimeType, createdAt.
page- Geçerli sayfa numarası.
pageSize- Sayfa başına öğe.
total- Kütüphanedeki toplam görsel.
{
"resources": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"fileName": "product.jpg",
"url": "https://cdn.phototourl.com/pro/2026-11-05-a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpg",
"fileSize": 128472,
"mimeType": "image/jpeg",
"createdAt": "2026-11-05 10:20:30"
}
],
"page": 1,
"pageSize": 20,
"total": 1
}Görsel sil
DELETE /api/v1/images/:id. Dosyayı depolamadan ve kütüphanenizden kaldırır.
curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Yanıt alanları
success- Görsel silindiğinde true.
{ "success": true }Limitler
API Free’de kullanılamaz. Pro ve Premium, planınızın yükleme, depolama ve dosya boyutu limitlerini kullanır. Limit aşılınca API, upgradeUrl içeren bir hata döndürür.
Hatalar
Başarısız istekler bir hata kodu döndürür. Kota hataları upgradeUrl içerebilir.
dailyLimitReached— Günlük yükleme limitine ulaşıldı (HTTP 429).storageLimitReached— Depolama kotası aşıldı (HTTP 413).fileTooLarge— Dosya planınızın izin verdiğinden büyük (HTTP 400).401— Eksik, geçersiz veya iptal edilmiş API anahtarı.
{
"error": "dailyLimitReached",
"errorParams": { "limit": 1000 },
"plan": "paid",
"limit": 1000,
"upgradeUrl": "https://www.phototourl.com/pricing"
}