Foto naar URL logo

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.

Productafbeeldingen

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