ใช้งาน API เบื้องต้น

สร้าง API Key แล้วอัปโหลดรูป สร้าง QR และสั่งบีบอัดผ่าน REST API

Uppic มี REST API ภายใต้ /api/v1 สำหรับอัปโหลด/จัดการรูป สร้าง QR Code และสั่งงานบีบอัดจากระบบของคุณเอง

การยืนยันตัวตน

  1. 1ไปที่ Dashboard → API Keys แล้วสร้างคีย์ใหม่ พร้อมเลือก scope ที่ต้องใช้ (เช่น images:write)
  2. 2คัดลอกคีย์ (ขึ้นต้น upk_) ทันที — ระบบแสดงค่าเต็มเพียงครั้งเดียว
  3. 3ส่งคีย์ใน header ของทุกคำขอ
Header ที่ต้องส่ง
Authorization: Bearer upk_YOUR_API_KEY
หมายเหตุ: Rate limit ตามแพ็กเกจ: Free 100 · Pro 2,000 · Business 10,000 ครั้ง/ชั่วโมง — เกินลิมิตจะได้ HTTP 429

อัปโหลดรูป

POST /api/v1/images/upload (ต้องมี scope images:write)
curl -X POST https://uppic.example/api/v1/images/upload \
  -H "Authorization: Bearer upk_YOUR_API_KEY" \
  -F "files=@photo.jpg" \
  -F "expiresIn=never" \
  -F "privacy=UNLISTED" \
  -F "stripExif=true"
ตัวอย่าง response (201)
{
  "results": [
    {
      "id": "aB3xY9…",
      "links": {
        "sharePage": "https://uppic.example/image/photo.aB3xY9…",
        "direct": "https://uppic.example/f/photo.jpg",
        "thumbnail": "https://uppic.example/f/photo.th.jpg",
        "medium": "https://uppic.example/f/photo.md.jpg"
      },
      "embed": { "html": "…", "markdown": "…", "bbcode": "…" },
      "fileName": "photo.jpg",
      "fileSize": 123456,
      "width": 1920,
      "height": 1080
    }
  ]
}

ตัวเลือกอื่นที่ส่งได้: title, sourceUrl (อัปโหลดจาก URL), galleryId (เพิ่มเข้าแกลเลอรี), และชุด optimize/outputFormat/quality/maxWidth สำหรับบีบอัดก่อนฝาก

สร้าง QR Code

POST /api/v1/qr-codes (ต้องมี scope qr:write)
curl -X POST https://uppic.example/api/v1/qr-codes \
  -H "Authorization: Bearer upk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Campaign QR",
    "mode": "DYNAMIC",
    "data": { "type": "url", "url": "https://example.com/landing" }
  }'
แก้ปลายทาง Dynamic QR ภายหลัง
curl -X PATCH https://uppic.example/api/v1/qr-codes/QR_ID \
  -H "Authorization: Bearer upk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "destinationUrl": "https://example.com/new-landing" }'

สั่งงานบีบอัด

POST /api/v1/optimizations (ต้องมี scope optimize:write)
# ส่งงาน (สูงสุด 20 ไฟล์ตามแพ็กเกจ)
curl -X POST https://uppic.example/api/v1/optimizations \
  -H "Authorization: Bearer upk_YOUR_API_KEY" \
  -F "files=@photo.png" -F "format=webp" -F "quality=80"

# เช็คสถานะงาน
curl https://uppic.example/api/v1/optimizations/JOB_ID \
  -H "Authorization: Bearer upk_YOUR_API_KEY"

# ดาวน์โหลดผลลัพธ์ทั้งชุดเป็น ZIP เมื่อเสร็จ
curl -L https://uppic.example/api/v1/optimizations/JOB_ID/download \
  -H "Authorization: Bearer upk_YOUR_API_KEY" -o results.zip
เคล็ดลับ: อยากรู้ทันทีเมื่องานเสร็จโดยไม่ต้อง polling? ตั้งค่า Webhooks เพื่อรับ event optimization.completed — ดูบทความ Webhooks ต่อได้เลย
บทความนี้ช่วยได้ไหม?

บทความที่เกี่ยวข้อง

ยังต้องการความช่วยเหลือ?

ทีมงานพร้อมตอบคำถามของคุณโดยตรง

ติดต่อเรา