Langsung ke konten
POST AI agent ready /v1/short-url/create

API Penyingkat URL - Buat Tautan Pendek dengan Pelacakan Klik

Kirimkan URL dan terima tautan singkat dengan siput yang dibuat secara otomatis atau khusus. Tautan pendek dialihkan melalui 302 dan melacak jumlah klik. Siput khusus mendukung huruf, angka, tanda hubung, dan garis bawah. Jika slug sudah diambil, API akan mengembalikan kesalahan sehingga Anda dapat mencoba lagi dengan kesalahan lain.

Parameters

stringrequired

The target URL to shorten. Must be a valid http or https URL.

string

An optional custom slug for the short URL. Letters, numbers, hyphens, and underscores only.

Code examples

curl -X POST https://api.botoi.com/v1/short-url/create \
  -H "Content-Type: application/json" \
  -d '{"url":"https://docs.botoi.com/getting-started","custom_slug":"getting-started"}'

When to use this API

Hasilkan tautan pendek yang dapat dilacak untuk kampanye pemasaran

Buat tautan pendek siput khusus untuk setiap kampanye (misalnya, /launch-2026). Gunakan titik akhir statistik untuk melacak klik dan mengukur keterlibatan tanpa alat analisis eksternal.

Bangun fitur pemendek tautan ke dalam produk SaaS Anda

Izinkan pengguna Anda membuat tautan pendek bermerek dari dalam aplikasi Anda. API menangani pembuatan slug, deteksi tabrakan, dan pelacakan pengalihan sehingga Anda tidak perlu membangun infrastruktur tersebut.

Frequently asked questions

Apakah tautan pendek kedaluwarsa?
Tautan pendek yang dibuat melalui API tidak memiliki masa berlaku bawaan. Mereka bertahan dalam penyimpanan hingga dihapus secara manual atau penyimpanan yang mendasarinya dihapus.
Apa yang terjadi jika siput khusus saya sudah diambil?
API mengembalikan kesalahan SLUG_TAKEN. Anda dapat mencoba lagi dengan slug yang berbeda atau menghilangkan bidang custom_slug untuk mendapatkan slug 6 karakter yang dibuat secara otomatis.
Karakter apa yang diperbolehkan di siput khusus?
Huruf (A-Z, a-z), angka (0-9), tanda hubung (-), dan garis bawah (_). Karakter lain menyebabkan kesalahan INVALID_SLUG.
Apakah jumlah klik dilacak secara otomatis?
Ya. Setiap kali seseorang mengunjungi URL pendek, penghitung klik bertambah. Gunakan titik akhir GET /v1/short-url/{slug}/stats untuk mengambil hitungan saat ini.
Jenis pengalihan apa yang digunakan URL pendek?
URL pendek mengembalikan pengalihan 302 (sementara). Ini berarti mesin pencari tidak akan mentransfer ekuitas tautan ke URL target, dan Anda dapat mengubah tujuannya nanti jika diperlukan.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs