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