โลโก้รูปภาพเป็น URL

เอกสาร 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"
}