Dokumentasi API
Akses API memerlukan langganan Pro atau Premium yang aktif. Sahkan dengan kunci API, kemudian muat naik imej ke pustaka yang sama seperti dalam Dashboard. Kuota mengikut pelan berbayar di laman web.
Muat naik imej
POST /api/v1/upload dengan multipart/form-data.
Parameter
Authorization- Wajib. Pengepala permintaan. Format: Bearer KUNCI_API_ANDA.
file- Wajib. Fail binari atau data base64.
name- Pilihan. Nama fail; dikesan secara automatik semasa muat naik multipart tempatan.
Contoh permintaan
Fail binari
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 memuat naik fail tempatan, sentiasa gunakan POST. GET tidak disokong.
Medan respons
id- Id sumber dalam pustaka anda.
url- URL CDN untuk halaman produk.
fileName- Nama fail asal.
fileSize- Saiz fail dalam bait.
mimeType- Jenis MIME fail yang dimuat naik.
createdAt- Masa muat naik 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"
}Senaraikan imej
GET /api/v1/images dengan page dan pageSize pilihan (maks. 100).
curl "https://phototourl.com/api/v1/images?page=1&pageSize=20" \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Medan respons
resources- Array imej: id, fileName, url, fileSize, mimeType, createdAt.
page- Nombor halaman semasa.
pageSize- Item setiap halaman.
total- Jumlah imej dalam 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
}Padam imej
DELETE /api/v1/images/:id. Membuang fail dari storan dan pustaka anda.
curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Medan respons
success- true apabila imej telah dipadam.
{ "success": true }Had
API tidak tersedia pada Free. Pro dan Premium menggunakan had muat naik, storan dan saiz fail pelan anda. Apabila melebihi had, API memulangkan ralat dengan upgradeUrl.
Ralat
Permintaan gagal memulangkan kod ralat. Ralat kuota mungkin termasuk upgradeUrl.
dailyLimitReached— Had muat naik harian dicapai (HTTP 429).storageLimitReached— Kuota storan melebihi (HTTP 413).fileTooLarge— Fail lebih besar daripada yang dibenarkan pelan (HTTP 400).401— Kunci API tiada, tidak sah atau dibatalkan.
{
"error": "dailyLimitReached",
"errorParams": { "limit": 1000 },
"plan": "paid",
"limit": 1000,
"upgradeUrl": "https://www.phototourl.com/pricing"
}