Bilde til URL logo

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.

Produktbilder

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"
}