API-dokumentation
API-åtkomst kräver ett aktivt Pro- eller Premium-abonnemang. Autentisera med en API-nyckel och ladda upp bilder till samma bibliotek som i Dashboard. Kvoterna motsvarar din betalda plan på webbplatsen.
Ladda upp en bild
POST /api/v1/upload med multipart/form-data.
Parametrar
Authorization- Obligatoriskt. Begärandehuvud. Format: Bearer DIN_API_NYCKEL.
file- Obligatoriskt. En binärfil eller base64-data.
name- Valfritt. Filnamn; upptäcks automatiskt vid lokal multipart-uppladdning.
Exempelförfrågan
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"
Använd alltid POST när du laddar upp en lokal fil. GET stöds inte.
Svarsfält
id- Resurs-id i ditt bibliotek.
url- CDN-URL för produktsidor.
fileName- Ursprungligt filnamn.
fileSize- Filstorlek i byte.
mimeType- MIME-typ för den uppladdade filen.
createdAt- Uppladdningstid 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"
}Lista bilder
GET /api/v1/images med valfria page och pageSize (max 100).
curl "https://phototourl.com/api/v1/images?page=1&pageSize=20" \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Svarsfält
resources- Array av bilder: id, fileName, url, fileSize, mimeType, createdAt.
page- Aktuellt sidnummer.
pageSize- Objekt per sida.
total- Totalt antal 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
}Ta bort en bild
DELETE /api/v1/images/:id. Tar bort filen från lagring och ditt bibliotek.
curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Svarsfält
success- true när bilden har tagits bort.
{ "success": true }Gränser
API är inte tillgängligt på Free. Pro och Premium använder planens uppladdnings-, lagrings- och filstorleksgränser. När du överskrider en gräns returnerar API:t ett fel med upgradeUrl.
Fel
Misslyckade förfrågningar returnerar en felkod. Kvotfel kan innehålla upgradeUrl.
dailyLimitReached— Daglig uppladdningsgräns nådd (HTTP 429).storageLimitReached— Lagringskvot överskriden (HTTP 413).fileTooLarge— Fil större än planen tillåter (HTTP 400).401— Saknad, ogiltig eller återkallad API-nyckel.
{
"error": "dailyLimitReached",
"errorParams": { "limit": 1000 },
"plan": "paid",
"limit": 1000,
"upgradeUrl": "https://www.phototourl.com/pricing"
}