เอกสาร API
การเข้าถึง API ต้องมีสมาชิก Pro หรือ Premium ที่ใช้งานอยู่ ยืนยันตัวตนด้วยคีย์ API แล้วอัปโหลดรูปไปยังคลังเดียวกับในแดชบอร์ด โควต้าตามแพ็กเกจที่ชำระบนเว็บ
อัปโหลดรูป
POST /api/v1/upload แบบ multipart/form-data
พารามิเตอร์
Authorization- จำเป็น ส่วนหัวคำขอ รูปแบบ Bearer คีย์_API_ของคุณ
file- จำเป็น ไฟล์ไบนารี หรือข้อมูล base64
name- ไม่บังคับ ชื่อไฟล์ ระบบตรวจจับอัตโนมัติเมื่ออัปโหลดไฟล์ท้องถิ่นแบบ multipart
ตัวอย่างคำขอ
ไฟล์ไบนารี
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"
อัปโหลดไฟล์ท้องถิ่นให้ใช้ POST เสมอ ไม่รองรับ GET
ฟิลด์ในคำตอบ
id- รหัสทรัพยากรในคลังของคุณ
url- URL CDN สำหรับหน้ารายละเอียดสินค้า
fileName- ชื่อไฟล์ต้นฉบับ
fileSize- ขนาดไฟล์เป็นไบต์
mimeType- ชนิด MIME ของไฟล์ที่อัปโหลด
createdAt- เวลาอัปโหลดเป็น UTC รูปแบบ 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"
}ดูรายการรูป
GET /api/v1/images พร้อม page และ pageSize ตามต้องการ (สูงสุด 100)
curl "https://phototourl.com/api/v1/images?page=1&pageSize=20" \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
ฟิลด์ในคำตอบ
resources- อาร์เรย์ของรูป: id, fileName, url, fileSize, mimeType, createdAt
page- หมายเลขหน้าปัจจุบัน
pageSize- จำนวนรายการต่อหน้า
total- จำนวนรูปทั้งหมดในคลัง
{
"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
}ลบรูป
DELETE /api/v1/images/:id ลบไฟล์ออกจากที่เก็บและคลังของคุณ
curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
ฟิลด์ในคำตอบ
success- true เมื่อลบรูปแล้ว
{ "success": true }ลิมิต
API ไม่มีใน Free Pro และ Premium ใช้ลิมิตอัปโหลด ที่เก็บ และขนาดไฟล์ของแพ็กเกจ เมื่อเกินลิมิต API จะคืนข้อผิดพลาดพร้อม upgradeUrl
ข้อผิดพลาด
คำขอที่ล้มเหลวคืนรหัสข้อผิดพลาด ข้อผิดพลาดโควต้าอาจมี upgradeUrl
dailyLimitReached— ถึงลิมิตอัปโหลดรายวันแล้ว (HTTP 429)storageLimitReached— เกินโควต้าที่เก็บ (HTTP 413)fileTooLarge— ไฟล์ใหญ่กว่าที่แพ็กเกจอนุญาต (HTTP 400)401— คีย์ API หาย ไม่ถูกต้อง หรือถูกเพิกถอน
{
"error": "dailyLimitReached",
"errorParams": { "limit": 1000 },
"plan": "paid",
"limit": 1000,
"upgradeUrl": "https://www.phototourl.com/pricing"
}