Overzicht van de REST API
OpenAPI 3.1 specificatie, basis-URL's, HTTP-headers en JSON-responsstructuur.
De SmallPict API is gebaseerd op REST-principes en voldoet aan de OpenAPI 3.1 standaarden. Dit garandeert voorspelbare verwerkingstijden en een consistent JSON-formaat.
Basis-URL's
| Omgeving | Basis-URL | Toepassing |
|---|---|---|
| Productie | https://api.smallpict.app/v1 | Live dataverkeer (verbruikt maandelijks tegoed). |
| Sandbox | https://api.smallpict.app/v1 | Lokale ontwikkeling en CI/CD met sp_test_... sleutels (gratis). |
Belangrijkste eindpunten
| Methode | Eindpunt | Beschrijving |
|---|---|---|
POST | /optimize | Beeld synchroniseren of asynchroon optimaliseren en converteren. |
GET | /status/{job_id} | Voortgang controleren van een asynchrone verwerkingstaak. |
GET | /quota | Pakketgegevens, resterend tegoed en verbruik opvragen. |
POST | /purge | Bestanden direct verwijderen uit de SmallPict Edge-cache. |
Standaard JSON-responsstructuur
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" }}