Dokumentasyon ng API
Kailangan ng aktibong Pro o Premium subscription ang access sa API. Mag-authenticate gamit ang API key, pagkatapos mag-upload ng larawan sa parehong library na nakikita sa Dashboard. Pareho ang quota sa bayad na plan sa website.
Mag-upload ng larawan
POST /api/v1/upload gamit ang multipart/form-data.
Mga parameter
Authorization- Kailangan. Header ng kahilingan. Format: Bearer ANG_IYONG_API_KEY.
file- Kailangan. Binaryong file o base64 na datos.
name- Opsyonal. Filename; awtomatikong nadedetect sa local multipart upload.
Halimbawang request
Binaryong file
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"
Palaging gumamit ng POST kapag nag-a-upload ng local file. Hindi suportado ang GET.
Mga field ng sagot
id- Resource id sa library mo.
url- CDN URL na magagamit sa pahina ng produkto.
fileName- Orihinal na filename.
fileSize- Laki ng file sa bytes.
mimeType- MIME type ng na-upload na file.
createdAt- Oras ng upload sa UTC, format na 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"
}Ilista ang mga larawan
GET /api/v1/images na may opsyonal na page at pageSize (max 100).
curl "https://phototourl.com/api/v1/images?page=1&pageSize=20" \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Mga field ng sagot
resources- Array ng mga larawan: id, fileName, url, fileSize, mimeType, createdAt.
page- Numero ng kasalukuyang page.
pageSize- Item bawat page.
total- Kabuuang larawan sa library.
{
"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
}Tanggalin ang larawan
DELETE /api/v1/images/:id. Tinatanggal ang file sa storage at sa library mo.
curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Mga field ng sagot
success- true kapag natanggal ang larawan.
{ "success": true }Mga limit
Hindi available ang API sa Free. Ginagamit ng Pro at Premium ang limit sa upload, storage, at laki ng file ng plan mo. Kapag lumampas sa limit, nagbabalik ang API ng error na may upgradeUrl.
Mga error
Ang nabigong request ay nagbabalik ng error code. Puwedeng may upgradeUrl ang mga error sa quota.
dailyLimitReached— Naabot na ang arawang limit sa upload (HTTP 429).storageLimitReached— Lumampas sa storage quota (HTTP 413).fileTooLarge— Mas malaki ang file kaysa pinapayagan ng plan (HTTP 400).401— Nawawala, invalid, o binawi ang API key.
{
"error": "dailyLimitReached",
"errorParams": { "limit": 1000 },
"plan": "paid",
"limit": 1000,
"upgradeUrl": "https://www.phototourl.com/pricing"
}