เริ่มต้นใช้งาน

สร้างลิงก์สั้นแบบหมดอายุได้ด้วย POST ครั้งเดียว

ส่ง URL พร้อมชื่อและเวลาหมดอายุถ้าต้องการ API จะคืน shortcode กับเวลาหมดอายุ ส่วน endpoint อื่นใช้สำหรับอ่านข้อมูลหรือลบลิงก์ที่สร้างไว้

POST/v1/links

คำขอshell · ตัวอย่าง

curl -X POST https://shor10.co/api/links \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"originalUrl":"https://example.com/very/long/path","alias":"spring-sale","ttl":"7d"}'

ข้อมูลใน BODY

urlต้องระบุURL แบบเต็มที่ขึ้นต้นด้วย http หรือ https

aliasไม่บังคับใช้ a-z, 0-9 และขีดกลางได้สูงสุด 12 ตัวอักษร ถ้าไม่ระบุ ระบบจะสุ่มให้

ttlไม่บังคับใช้ 1h · 24h · 7d · 30d หรือ null ถ้าไม่ต้องการให้หมดอายุ

201 CREATED

{
  "shortcode": "spring-sale",
  "url": "https://shor10.co/spring-sale",
  "expiresAt": "2026-08-03T09:00:00Z",
  "state": "live"
}

การลบลิงก์

การลบผ่าน API ให้ผลเหมือนลบจาก Dashboard โดย shortcode จะหยุดทำงานทันที ประวัติจะถูกเก็บใน Archive และมีเพียงเจ้าของบัญชีเท่านั้นที่ลบได้ผ่าน session หรือ Bearer key

DELETE/api/links/:id→ 204, ไม่มี response body

curl -X DELETE https://shor10.co/api/links/<id> \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxx"

รหัสสถานะ

รหัสความหมายเกิดเมื่อ

201สร้างสำเร็จลิงก์ถูกสร้างและพร้อมใช้งาน

302พบลิงก์ค่าที่ผู้เข้าชมได้รับเมื่อเปิด shor10.co/shortcode

409ชื่อซ้ำalias นี้ถูกใช้แล้ว response body จะแนะนำชื่อที่ยังว่าง

404ไม่พบไม่เคยมีลิงก์ที่ใช้ shortcode นี้

410หมดอายุเคยมีลิงก์นี้ แต่หมดอายุแล้ว response จะมีค่า expiredAt

429ส่งคำขอมากเกินไปใช้จำนวน API call ต่อวันครบแล้ว Retry-After ระบุเวลาที่ควรรอก่อนลองใหม่ หน่วยเป็นวินาที

สร้าง key ได้ที่ Settings

สร้าง key ใน Settings > API keys จากนั้นส่ง Authorization: Bearer sk_live_… ไปกับ GET/POST /api/links และ DELETE /api/links/:id

เปิดหน้า API keys