REST API Genel Bakışı
OpenAPI 3.1 spesifikasyonu, temel URL'ler, HTTP başlıkları ve standart JSON yanıtları.
SmallPict API'si RESTful ilkelerine göre inşa edilmiş olup OpenAPI 3.1 standartlarına uygundur. Öngörülebilir yanıt süreleri ve tutarlı JSON çıktıları sağlar.
Temel Servis URL'leri
| Ortam | Temel URL | Kullanım Alanı |
|---|---|---|
| Canlı (Production) | https://api.smallpict.app/v1 | Üretim ortamı uygulamaları (aylık kotadan düşer). |
| Sandbox | https://api.smallpict.app/v1 | sp_test_... anahtarlarıyla testler (ücretsiz). |
Temel Uç Noktalar
| Metot | Uç Nokta | İşlev |
|---|---|---|
POST | /optimize | Görseli eşzamanlı veya eşzamansız optimize eder ve dönüştürür. |
GET | /status/{job_id} | Kuyruktaki eşzamansız bir görevin ilerlemesini denetler. |
GET | /quota | Plan ayrıntılarını, kalan bakiyeyi ve tüketimi getirir. |
POST | /purge | Belirtilen dosyaları SmallPict CDN önbelleğinden temizler. |
Standart JSON Yanıt Formatı
Response · 200 OK
{ "success": true, "data": { "job_id": "job_1a2b3c4d5e6f", "status": "completed", "original_size": 2048500, "optimized_size": 256100, "savings_percentage": 87.49, "format": "avif", "url": "https://cdn.smallpict.app/media/hero.avif" }}