Gozi.to

API

สร้างและจัดการลิงก์สั้นจากสคริปต์และแอป API ใช้ได้ฟรี สร้างคีย์ในแดชบอร์ดของคุณที่หัวข้อ คีย์ API แล้วส่งเป็น bearer token

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

Authorization: Bearer gz_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

คีย์จะแสดงเพียงครั้งเดียว ปฏิบัติกับคีย์เหมือนรหัสผ่าน ใครก็ตามที่มีคีย์ของคุณสร้างและแก้ไขลิงก์ในบัญชีของคุณได้ หากคีย์รั่วไหล ให้เพิกถอนจากแดชบอร์ด

ขีดจำกัด

สร้างลิงก์

curl -X POST https://gozi.to/api/my/links \
  -H "Authorization: Bearer $GOZI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/launch", "code": "launch"}'

code จะใส่หรือไม่ใส่ก็ได้ (4–32 ตัว: ตัวอักษร ตัวเลข - หรือ _) ถ้าไม่ใส่ จะได้รหัสสุ่ม 7 ตัวอักษร การตอบกลับ 201:

{
  "link": {
    "code": "launch",
    "shortUrl": "https://gozi.to/launch",
    "url": "https://example.com/launch",
    "status": "active",
    "statusReason": null,
    "custom": true,
    "createdAt": 1790000000000,
    "expiresAt": null
  }
}

รายการลิงก์

GET /api/my/links?limit=25&cursor=<nextCursor>&q=<search>&clicks=1

เรียงใหม่สุดก่อน ส่ง nextCursor จากหน้าก่อนหน้าเพื่อขอหน้าถัดไป clicks=1 จะเพิ่มยอดคลิกจากคนจริงตลอดกาลเข้าไปด้วย

ดู แก้ไข ลบ

GET    /api/my/links/{code}
PATCH  /api/my/links/{code}   {"url": "https://new.example"}  or  {"status": "disabled" | "active"}
DELETE /api/my/links/{code}

สถิติ

GET /api/my/links/{code}/stats

คืนค่ายอดคลิกจากคนจริงใน 90 วันล่าสุดและตลอดกาล ยอดคลิกต่อวัน รวมถึงประเทศ แหล่งอ้างอิง อุปกรณ์ เบราว์เซอร์ และระบบปฏิบัติการอันดับต้น ๆ บอตและการดึงตัวอย่างลิงก์ (Slack, WhatsApp และอื่น ๆ) ถูกนับแยกไว้ใน botClicks ผลลัพธ์ถูกแคชไว้ประมาณ 5 นาที

ข้อผิดพลาด

ข้อผิดพลาดใช้รหัสสถานะ HTTP และเนื้อหาแบบ JSON:

{ "error": { "code": "slug_taken", "message": "That custom link is already taken." } }

คำอธิบายทุกปลายทางในรูปแบบที่เครื่องอ่านได้อยู่ที่ /openapi.json