Dokumentasi API

API publik untuk membuat dan mengelola link pendek beserta analytics-nya. Semua endpoint memerlukan header Authorization: Bearer <API key> (buat di halaman API pada dashboard). Rate limit 120 request/menit per key; sisa kuota ada di header x-ratelimit-*.

Buat API key →·Unduh spesifikasi OpenAPI (JSON)

Autentikasi

curl https://s.saltanera.com/api/v1/links \
  -H "Authorization: Bearer sl_..."
get/api/v1/links

Daftar link (berpaginasi)

Parameter

  • limit (query)
  • offset (query)
  • search (query) — Cari di slug, URL, dan judul

Respons

  • 200 — Daftar link
  • 401 — Kesalahan
  • 429 — Kesalahan
post/api/v1/links

Buat link baru

Respons

  • 201 — Link dibuat
  • 400 — Kesalahan
  • 409 — Slug sudah dipakai
get/api/v1/links/{idOrSlug}

Detail satu link

Parameter

  • idOrSlug (path) — ID internal atau slug link

Respons

  • 200 — Link
  • 404 — Kesalahan
patch/api/v1/links/{idOrSlug}

Ubah link

Field yang tidak dikirim dibiarkan. String kosong pada field opsional menghapus nilainya. Tambahan: archived (boolean), removePassword (boolean).

Parameter

  • idOrSlug (path) — ID internal atau slug link

Respons

  • 200 — Link setelah diubah
  • 400 — Kesalahan
  • 404 — Kesalahan
delete/api/v1/links/{idOrSlug}

Hapus link

Parameter

  • idOrSlug (path) — ID internal atau slug link

Respons

  • 200 — Terhapus
  • 404 — Kesalahan
get/api/v1/links/{idOrSlug}/stats

Analytics satu link

Parameter

  • idOrSlug (path)
  • days (query)

Respons

  • 200 — Agregat: total, klik harian, jam & hari ramai, pengunjung unik, serta breakdown referrer/browser/OS/perangkat/negara/varian.
  • 404 — Kesalahan