API-dokumentasjon
API krever aktivt Pro- eller Premium-abonnement. Autentiser med en API-nøkkel, og last opp bilder til samme bibliotek som i Dashbordet. Kvoten følger betalt plan på nettsiden.
Last opp et bilde
POST /api/v1/upload med multipart/form-data.
Parametere
Authorization- Påkrevd. Forespørselshode. Format: Bearer DIN_API_NØKKEL.
file- Påkrevd. En binærfil eller base64-data.
name- Valgfritt. Filnavn; gjenkjennes automatisk ved lokal multipart-opplasting.
Eksempelforespørsel
Binærfil
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"
Bruk alltid POST når du laster opp en lokal fil. GET støttes ikke.
Svarfelter
id- Ressurs-id i biblioteket ditt.
url- CDN-URL du kan bruke på produktsider.
fileName- Opprinnelig filnavn.
fileSize- Filstørrelse i byte.
mimeType- MIME-type for den opplastede filen.
createdAt- Opplastingstid i UTC, formatert som 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 bilder
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 av bilder: id, fileName, url, fileSize, mimeType, createdAt.
page- Gjeldende sidenummer.
pageSize- Elementer per side.
total- Totalt antall bilder 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
}Slett et bilde
DELETE /api/v1/images/:id. Fjerner filen fra lagring og biblioteket ditt.
curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Svarfelter
success- true når bildet ble slettet.
{ "success": true }Grenser
API er ikke tilgjengelig på Free. Pro og Premium bruker planens opplastings-, lagrings- og filstørrelsesgrenser. Når du overskrider en grense, returnerer API en feil med upgradeUrl.
Feil
Mislykkede forespørsler returnerer en feilkode. Kvotefeil kan inkludere upgradeUrl.
dailyLimitReached— Daglig opplastingsgrense nådd (HTTP 429).storageLimitReached— Lagringskvote overskredet (HTTP 413).fileTooLarge— Filen er større enn planen tillater (HTTP 400).401— Manglende, ugyldig eller tilbakekalt API-nøkkel.
{
"error": "dailyLimitReached",
"errorParams": { "limit": 1000 },
"plan": "paid",
"limit": 1000,
"upgradeUrl": "https://www.phototourl.com/pricing"
}