API ของ CTAurl จะทำอะไรได้บ้าง
API ของ CTAurl ยังไม่เปิดให้ใช้ เมื่อเปิดแล้วจะใช้สร้างลิงก์ย่อและ QR code จากซอฟต์แวร์ของคุณเอง เป็น REST API ขนาดเล็กที่ทำงานผ่าน HTTPS และรับส่งข้อมูลเป็น JSON อยู่ที่ https://app.ctaurl.com/api/v1 ทุกคำขอจะยืนยันตัวตนด้วย bearer token จากเวิร์กสเปซของคุณ และ API จะรับคำขอต่อไปนี้:
| คำขอ | ทำอะไร |
|---|---|
POST /links | สร้างลิงก์บนโดเมน CTA หรือ ctaurl.me จะกำหนดส่วนท้ายลิงก์ ชื่อ แท็ก และเวลาหมดอายุ (expiresAt) ด้วยก็ได้ |
GET /links/{id} | อ่านข้อมูลลิงก์หนึ่งลิงก์ |
PATCH /links/{id} | ปิดใช้งานลิงก์ ({"disabled": true}) |
POST /qr-codes | สร้างQR code ให้ลิงก์ที่มีอยู่แล้ว หรือสร้างลิงก์ใหม่พร้อมQR code ในคำขอเดียว |
GET /qr-codes/{id} | อ่านข้อมูลQR code |
PATCH /qr-codes/{id} | เปลี่ยนสีและสไตล์ของQR code |
GET /qr-codes/{id}/svg, /png | ดาวน์โหลดQR code เป็น SVG หรือ PNG |
โทเค็น API และสิทธิ์การใช้งาน
เจ้าของเวิร์กสเปซสร้างโทเค็น API ของ CTAurl ได้ในแอป ที่เมนู Settings → API keys (การตั้งค่า → คีย์ API) โทเค็นแต่ละตัวเป็นแบบ Read only (อ่านอย่างเดียว) หรือ Manage (อ่านและสร้าง) ระบบแสดงโทเค็นให้เห็นครั้งเดียวตอนสร้าง และเพิกถอนได้ทุกเมื่อ หนึ่งเวิร์กสเปซมีโทเค็นที่ใช้งานอยู่ได้สูงสุด 20 ตัว ส่งโทเค็นในเฮดเดอร์ Authorization:
Authorization: Bearer cta_live_…วิธีสร้างลิงก์ย่อผ่าน API
เมื่อ API เปิดใช้งานแล้ว ถ้าจะสร้างลิงก์ย่อ ให้ส่ง POST /links พร้อม bearer token, Idempotency-Key และ body แบบ JSON ทุกคำขอสร้างต้องมี Idempotency-Key ซึ่งประกอบด้วยเวลาแบบ Unix หน่วยมิลลิวินาที ตามด้วยจุด และ UUID v4 ถ้าคำขอหมดเวลา ให้ส่งซ้ำด้วยคีย์เดิมภายใน 24 ชั่วโมง คุณจะได้ผลลัพธ์เดิมกลับมาแทนการได้ลิงก์ที่สอง
curl https://app.ctaurl.com/api/v1/links \
-H "Authorization: Bearer $CTAURL_TOKEN" \
-H "Idempotency-Key: 1761638400000.7f8c2a54-3b1e-4c6d-9a0f-2e5b8c1d4f60" \
-H "Content-Type: application/json" \
-d '{"domain":"ซื้อ.online","shortCode":"sneaker","destinationUrl":"https://shop.abc.yz/sneaker"}'คำขอที่สำเร็จจะตอบ 201 พร้อมข้อมูลลิงก์ รวมถึง shortUrl ถ้าไม่ใส่ shortCode ระบบจะสร้างส่วนท้ายลิงก์ให้เอง ลิงก์ที่สร้างผ่าน API จะนับรวมในโควตารายเดือนเดียวกับลิงก์ที่สร้างในแอป
ขีดจำกัดจำนวนคำขอและข้อผิดพลาด
API ของ CTAurl จะรับได้ 60 คำขอต่อนาทีต่อเวิร์กสเปซ ส่งข้อผิดพลาดกลับเป็น JSON พร้อมรหัสที่ไม่เปลี่ยนไปมา และรับคำขอที่ app.ctaurl.com เท่านั้น
- 60 คำขอต่อนาทีต่อเวิร์กสเปซ ถ้าเกินจะได้คำตอบ
429พร้อมRetry-After - ข้อผิดพลาดส่งกลับเป็น JSON:
{"error": {"code": "…", "message": "…"}}พร้อมรหัสที่ไม่เปลี่ยนไปมา เช่นINVALID_REQUEST,FORBIDDEN_SCOPEหรือRESOURCE_UNAVAILABLE - รับคำขอที่
app.ctaurl.comเท่านั้น
สิ่งที่ API ยังทำไม่ได้
นอกจากยังไม่เปิดใช้งานแล้ว API ของ CTAurl ยังแสดงรายการลิงก์ทั้งหมดไม่ได้ ยังเปลี่ยนปลายทางของลิงก์ไม่ได้ (ให้เปลี่ยนในแอป) และยังส่งยอดคลิกกับยอดสแกนกลับมาไม่ได้ ยังไม่มี webhook และ SDK และยังใช้โดเมนของคุณเองไม่ได้ เมื่อมีอย่างใดอย่างหนึ่งเพิ่มเข้ามา หน้านี้จะแจ้งไว้
คำถามที่คนถามบ่อยเกี่ยวกับ API
CTAurl มี API ไหม
ยังไม่มี API ของ CTAurl สร้างเสร็จแล้วแต่ยังไม่เปิดใช้งาน เมื่อเปิดแล้วจะสร้างและอ่านลิงก์ย่อกับ QR code ปิดใช้งานลิงก์ และดาวน์โหลด QR code เป็น SVG หรือ PNG ได้ ด้วยโทเค็นที่เจ้าของเวิร์กสเปซสร้างที่ Settings (การตั้งค่า), API keys API นี้ไม่แสดงรายการลิงก์ ไม่เปลี่ยนปลายทาง ไม่ส่งยอดคลิก และไม่ส่ง webhook
API ของ CTAurl มีขีดจำกัดจำนวนคำขอไหม
มี เมื่อเปิดใช้งานแล้ว API ของ CTAurl จะรับได้ 60 คำขอต่อนาทีต่อเวิร์กสเปซ คำขอที่เกินขีดจำกัดจะได้คำตอบ 429 พร้อมเฮดเดอร์ Retry-After ลิงก์ที่สร้างผ่าน API จะนับรวมในโควตาลิงก์รายเดือนของแพ็กเกจด้วย เหมือนลิงก์ที่สร้างในแอป