API Dokümantasyonu

API'mizi kullanarak programatik olarak resim yükleyin

ImageUpload.app API'si, web uygulamalarınıza, mobil uygulamalarınıza veya backend sistemlerinize resim yükleme özelliği entegre etmenizi sağlar. RESTful API'miz ile saniyeler içinde resim yükleyebilir, JavaScript SDK'mız ile hızlıca entegrasyon yapabilirsiniz. API anahtarınızı oluşturun ve hemen kullanmaya başlayın!

Başlangıç

1. API Anahtarınızı Alın

Öncelikle bir hesap oluşturmanız ve API anahtarı üretmeniz gerekiyor hesap sayfanızdan.

2. API İstekleri Yapın

API anahtarınızı aşağıdaki yöntemlerden biriyle ekleyin:

  • Authorization başlığı: Authorization: Bearer YOUR_API_KEY
  • İstek gövdesi: key=YOUR_API_KEY
  • Sorgu parametresi: ?key=YOUR_API_KEY

Resim Yükle

POST https://imageupload.app/api/1/upload
Parametreler
Parametre Tip Zorunlu Açıklama
key string Yes API anahtarınız
images file Yes Yüklenecek resim dosya(lar)ı (maksimum 5 dosya, her biri 4MB)
Örnek İstek (cURL)
curl -X POST "https://imageupload.app/api/1/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "images=@/path/to/your/image.jpg"
Örnek İstek (JavaScript)
const formData = new FormData();
formData.append('images', fileInput.files[0]);
formData.append('key', 'YOUR_API_KEY');

fetch('https://imageupload.app/api/1/upload', {
  method: 'POST',
  body: formData
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
Yanıt (Tek Resim)
{
  "status": 200,
  "success": true,
  "data": {
    "id": "abc123def456",
    "title": "image.jpg",
    "url_viewer": "https://imageupload.app/i/abc123def456",
    "url": "https://i.imageupload.app/abc123def456.jpg",
    "display_url": "https://i.imageupload.app/abc123def456.jpg",
    "size": 102400,
    "time": 1698765432,
    "image": {
      "filename": "abc123def456.jpg",
      "name": "abc123def456",
      "mime": "image/jpeg",
      "extension": "jpg",
      "url": "https://i.imageupload.app/abc123def456.jpg"
    }
  }
}
Yanıt (Birden Fazla Resim)
{
  "status": 200,
  "success": true,
  "data": {
    "images": [
      {
        "id": "abc123def456",
        "url": "https://i.imageupload.app/abc123def456.jpg",
        ...
      },
      {
        "id": "xyz789uvw012",
        "url": "https://i.imageupload.app/xyz789uvw012.jpg",
        ...
      }
    ],
    "count": 2
  }
}

JavaScript SDK

Web sitenize kolay entegrasyon için basit bir JavaScript kütüphanesi sağlıyoruz.

Kurulum
<script src="https://imageupload.app/imageupload-sdk.min.js"></script>
Temel Kullanım
// Initialize the SDK
const uploader = new ImageUploadApp('YOUR_API_KEY');

// Upload a single file
uploader.upload(fileInput.files[0])
  .then(response => {
    console.log('Upload successful:', response.url);
  })
  .catch(error => {
    console.error('Upload failed:', error);
  });
Birden Fazla Dosya Yükle
const uploader = new ImageUploadApp('YOUR_API_KEY');

uploader.uploadMultiple(fileInput.files)
  .then(response => {
    console.log('Uploads successful:', response);
  })
  .catch(error => {
    console.error('Upload failed:', error);
  });
Yükleme Widget'ı Oluştur
const uploader = new ImageUploadApp('YOUR_API_KEY');

uploader.createUploadWidget({
  multiple: true,
  onStart: (files) => {
    console.log('Starting upload:', files.length, 'files');
  },
  onProgress: (percent) => {
    console.log('Upload progress:', percent + '%');
  },
  onSuccess: (response, files) => {
    console.log('Upload successful:', response);
  },
  onError: (error, files) => {
    console.error('Upload failed:', error);
  }
});
Tam Örnek
<!DOCTYPE html>
<html>
<head>
    <title>Image Upload Example</title>
    <script src="https://imageupload.app/imageupload-sdk.min.js"></script>
</head>
<body>
    <button id="uploadBtn">Upload Image</button>
    <div id="result"></div>

    <script>
        const uploader = new ImageUploadApp('YOUR_API_KEY');
        
        document.getElementById('uploadBtn').addEventListener('click', function() {
            uploader.createUploadWidget({
                multiple: false,
                onSuccess: (response) => {
                    document.getElementById('result').innerHTML = 
                        '<img src="' + response.url + '" style="max-width: 300px;">';
                },
                onError: (error) => {
                    alert('Upload failed: ' + error.message);
                }
            });
        });
    </script>
</body>
</html>

Hata Kodları

Kod Mesaj Açıklama
100 No API key provided İstekten API anahtarı eksik
110 Invalid API key Sağlanan API anahtarı geçerli değil
120 User not found API anahtarıyla ilişkili kullanıcı bulunamadı
130 File size too large Dosya maksimum 4MB boyut sınırını aşıyor
131 Too many files Bir seferde maksimum 5 dosya yüklenebilir
140 No image file provided İstekte resim dosyası bulunmuyor
150 No files could be uploaded Tüm dosyalar yüklenemedi

Neden ImageUpload.app API'sini Kullanmalısınız?

🚀 Hızlı ve Güvenilir

Yüksek performanslı sunucularımız ile resimleriniz anında yüklenir ve her zaman erişilebilir durumda kalır.

🔒 Güvenli

API anahtarlarınız güvenli bir şekilde saklanır ve tüm istekler HTTPS üzerinden şifrelenir.

📱 Kolay Entegrasyon

RESTful API ve JavaScript SDK ile her platforma kolayca entegre edin. Detaylı dokümantasyon ve örneklerle başlamak çok kolay!

API Anahtarı Oluştur