API-dokumentation
API-adgang kræver et aktivt Pro- eller Premium-abonnement. Autentificér med en API-nøgle, og upload billeder til det samme bibliotek som i Dashboard. Kvoter matcher dit betalte abonnement på websitet.
Upload et billede
POST /api/v1/upload med multipart/form-data.
Parametre
Authorization- Påkrævet. Request-header. Format: Bearer DIN_API_NØGLE.
file- Påkrævet. En binær fil eller base64-data.
name- Valgfri. Filnavn; genkendes automatisk ved lokal multipart-upload.
Eksempelanmodning
Binær fil
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"
Brug altid POST ved upload af en lokal fil. GET understøttes ikke.
Svarfelter
id- Ressource-id i dit bibliotek.
url- CDN-URL til produktsider.
fileName- Oprindeligt filnavn.
fileSize- Filstørrelse i bytes.
mimeType- MIME-type for den uploadede fil.
createdAt- Uploadtid i UTC, format 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"
}List billeder
GET /api/v1/images med valgfri page og pageSize (maks. 100).
curl "https://phototourl.com/api/v1/images?page=1&pageSize=20" \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Svarfelter
resources- Array af billeder: id, fileName, url, fileSize, mimeType, createdAt.
page- Aktuelt sidenummer.
pageSize- Elementer pr. side.
total- Samlet antal billeder i biblioteket.
{
"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
}Slet et billede
DELETE /api/v1/images/:id. Fjerner filen fra lagring og dit bibliotek.
curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Svarfelter
success- true, når billedet er slettet.
{ "success": true }Grænser
API er ikke tilgængelig på Free. Pro og Premium bruger abonnementets upload-, lager- og filstørrelsesgrænser. Ved overskridelse returnerer API’en en fejl med upgradeUrl.
Fejl
Mislykkede anmodninger returnerer en fejlkode. Kvotefejl kan indeholde upgradeUrl.
dailyLimitReached— Daglig uploadgrænse nået (HTTP 429).storageLimitReached— Lagerkvote overskredet (HTTP 413).fileTooLarge— Fil større end abonnementet tillader (HTTP 400).401— Manglende, ugyldig eller tilbagekaldt API-nøgle.
{
"error": "dailyLimitReached",
"errorParams": { "limit": 1000 },
"plan": "paid",
"limit": 1000,
"upgradeUrl": "https://www.phototourl.com/pricing"
}