API

Buat dan kelola tautan pendek dari skrip dan aplikasi. API ini gratis. Buat kunci di dasbor Anda pada bagian Kunci API, lalu kirimkan sebagai bearer token.

Autentikasi

Authorization: Bearer gz_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Kunci hanya ditampilkan sekali. Perlakukan seperti kata sandi: siapa pun yang punya kunci Anda bisa membuat dan mengubah tautan di akun Anda. Cabut kunci yang bocor dari dasbor.

Batasan

60 permintaan per menit per kunci.
500 tautan baru per hari per akun.
Tujuan diperiksa dengan Google Safe Browsing dan daftar blokir kami. Layanan pemendek tautan lain tidak bisa dipakai sebagai tujuan.

Membuat tautan

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 bersifat opsional (4–32 huruf, angka, - atau _). Kosongkan untuk mendapat kode acak 7 karakter. Respons 201:

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

Daftar tautan

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

Terbaru lebih dulu. Kirim nextCursor dari halaman sebelumnya untuk mengambil halaman berikutnya. clicks=1 menambahkan jumlah klik manusia sepanjang waktu.

Ambil, ubah, hapus

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

Analitik

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

Mengembalikan klik manusia untuk 90 hari terakhir dan sepanjang waktu, klik per hari, serta negara, perujuk, perangkat, peramban, dan sistem operasi teratas. Bot dan pratinjau tautan (Slack, WhatsApp, dan sebagainya) dihitung terpisah di botClicks. Hasil disimpan dalam cache sekitar 5 menit.

Kesalahan

Kesalahan menggunakan kode status HTTP dan bodi JSON:

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

400 masukan tidak valid (invalid_url, invalid_slug, …)
401 kunci tidak ada, tidak valid, atau sudah dicabut
409 tautan khusus sudah dipakai
422 tujuan tidak diizinkan (destination_blocked)
429 batas laju atau batas harian tercapai

Deskripsi setiap endpoint yang bisa dibaca mesin tersedia di /openapi.json.