Logo Foto ke URL

Dokumentasi API

Akses API membutuhkan langganan Pro atau Premium yang aktif. Autentikasi dengan kunci API, lalu unggah gambar ke pustaka yang sama seperti di Dashboard. Kuota mengikuti paket berbayar di situs.

Gambar produk

Unggah gambar

POST /api/v1/upload dengan multipart/form-data.

Parameter

Authorization
Wajib. Header permintaan. Format: Bearer KUNCI_API_ANDA.
file
Wajib. File biner atau data base64.
name
Opsional. Nama file; terdeteksi otomatis saat upload multipart lokal.

Contoh permintaan

File biner

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"

Untuk mengunggah file lokal, selalu gunakan POST. GET tidak didukung.

Bidang respons

id
Id sumber daya di pustaka Anda.
url
URL CDN yang bisa dipakai di halaman produk.
fileName
Nama file asli.
fileSize
Ukuran file dalam byte.
mimeType
Tipe MIME file yang diunggah.
createdAt
Waktu unggah dalam 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"
}

Daftar gambar

GET /api/v1/images dengan page dan pageSize opsional (maks. 100).

curl "https://phototourl.com/api/v1/images?page=1&pageSize=20" \
  -H "Authorization: Bearer ptu_live_YOUR_KEY"

Bidang respons

resources
Array gambar: id, fileName, url, fileSize, mimeType, createdAt.
page
Nomor halaman saat ini.
pageSize
Item per halaman.
total
Total gambar di pustaka.
{
  "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
}

Hapus gambar

DELETE /api/v1/images/:id. Menghapus file dari penyimpanan dan pustaka Anda.

curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \
  -H "Authorization: Bearer ptu_live_YOUR_KEY"

Bidang respons

success
true bila gambar berhasil dihapus.
{ "success": true }

Batas

API tidak tersedia di Free. Pro dan Premium memakai batas unggah, penyimpanan, dan ukuran file paket Anda. Jika melebihi batas, API mengembalikan error dengan upgradeUrl.

Error

Permintaan gagal mengembalikan kode error. Error kuota dapat menyertakan upgradeUrl.

  • dailyLimitReached— Batas unggah harian tercapai (HTTP 429).
  • storageLimitReached— Kuota penyimpanan terlampaui (HTTP 413).
  • fileTooLarge— File lebih besar dari yang diizinkan paket (HTTP 400).
  • 401— Kunci API hilang, tidak valid, atau dicabut.
{
  "error": "dailyLimitReached",
  "errorParams": { "limit": 1000 },
  "plan": "paid",
  "limit": 1000,
  "upgradeUrl": "https://www.phototourl.com/pricing"
}