Fotoğrafı URL'ye logosu

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.

Ürün görselleri

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