API-documentatie
API-toegang vereist een actief Pro- of Premium-abonnement. Authenticeer met een API-sleutel en upload afbeeldingen naar dezelfde bibliotheek als in het Dashboard. Quota komen overeen met je betaalde abonnement op de site.
Een afbeelding uploaden
POST /api/v1/upload met multipart/form-data.
Parameters
Authorization- Verplicht. Requestheader. Formaat: Bearer UW_API_SLEUTEL.
file- Verplicht. Een binair bestand of base64-gegevens.
name- Optioneel. Bestandsnaam; bij lokaal multipart-upload automatisch herkend.
Voorbeeldverzoek
Binair bestand
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"
Gebruik altijd POST voor lokale bestanden. Upload via GET wordt niet ondersteund.
Responsvelden
id- Resource-id in je bibliotheek.
url- CDN-URL voor productpagina’s.
fileName- Oorspronkelijke bestandsnaam.
fileSize- Bestandsgrootte in bytes.
mimeType- MIME-type van het geüploade bestand.
createdAt- Uploadtijd in UTC, formaat 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"
}Afbeeldingen tonen
GET /api/v1/images met optioneel page en pageSize (max. 100).
curl "https://phototourl.com/api/v1/images?page=1&pageSize=20" \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Responsvelden
resources- Array van afbeeldingen: id, fileName, url, fileSize, mimeType, createdAt.
page- Huidig paginanummer.
pageSize- Items per pagina.
total- Totaal aantal afbeeldingen in de bibliotheek.
{
"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
}Een afbeelding verwijderen
DELETE /api/v1/images/:id. Verwijdert het bestand uit opslag en je bibliotheek.
curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Responsvelden
success- true wanneer de afbeelding is verwijderd.
{ "success": true }Limieten
API is niet beschikbaar op Free. Pro en Premium gebruiken de upload-, opslag- en bestandsgrootelimieten van je abonnement. Bij overschrijding geeft de API een fout met upgradeUrl.
Fouten
Mislukte verzoeken geven een foutcode. Quotafouten kunnen upgradeUrl bevatten.
dailyLimitReached— Dagelijkse uploadlimiet bereikt (HTTP 429).storageLimitReached— Opslagquota overschreden (HTTP 413).fileTooLarge— Bestand groter dan je abonnement toestaat (HTTP 400).401— Ontbrekende, ongeldige of ingetrokken API-sleutel.
{
"error": "dailyLimitReached",
"errorParams": { "limit": 1000 },
"plan": "paid",
"limit": 1000,
"upgradeUrl": "https://www.phototourl.com/pricing"
}