Dokumentasi API

Shortening URL lewat API dengan kunci akun. Format balinan mengikuti gaya s.ee.

Mendapatkan kunci

Buka Setelan & API di dasbor — kunci API tersedia di sana dan bisa di-regenerasi kapan saja.

Membuat tautan

curl -X POST "https://bagi.link/api/v1/shorten" \
  -H "Authorization: Bearer see_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "target_url": "https://contoh.com/panjang",
    "custom_slug": "promo",
    "title": "Promo Juli",
    "password": "1234",
    "expire_at": 1760000000,
    "expiration_redirect_url": "https://contoh.com/selesai"
  }'

Balasan (format ala s.ee):

{
  "code": 0,
  "message": "OK",
  "data": {
    "slug": "promo",
    "short_url": "https://bagi.link/promo"
  }
}

Mode sederhana

Tambahkan json=false untuk mendapat balikan teks polos (cocok untuk skrip & QR).

curl "https://bagi.link/api/v1/shorten?target_url=https://contoh.com&json=false" \
  -H "Authorization: Bearer see_xxx"
# → https://bagi.link/abc123

Parameter

  • target_url — tujuan (wajib, http/https).
  • custom_slug — slug pilihanmu.
  • title, tag — keterangan & pengelompokan.
  • password — lindungi tautan (3–32 karakter).
  • expire_at — waktu kedaluwarsa (unix detik).
  • expiration_redirect_url — tujuan setelah kedaluwarsa (fitur Langganan).

Batas & galat

  • 401 — kunci API tidak valid.
  • 403 — fitur premium di luar paket akun.
  • 429 — terlalu sering meminta.