API v1.0 • Cloudflare Edge Sub-15ms

1stdev.link Developer API

Dokumentasi integrasi resmi untuk shortlink, bio profil, dan sistem otomasi di 1stdev.link

1. Otentikasi

Sertakan API Key atau Token Anda pada setiap permintaan API yang membutuhkan hak akses:

Authorization: Bearer <api_key_atau_token>
# Atau
X-API-Key: <api_key>

API Key dapat ditemukan di Dashboard menu Akun > Pengembang > Kunci API.

2. Endpoint Utama

POST /api/links Wajib API Key

Buat tautan pendek baru atau tambahkan blok ke halaman profil bio.

Permintaan:

POST /api/links
Content-Type: application/json

{
  "title": "Katalog Menu Kopi",
  "destination_url": "https://1stdev.space/fitur",
  "slug": "katalog-kopi",
  "is_bio_entry": true,
  "block_type": "featured"
}

Respon (201 Created):

{
  "status": "success",
  "data": {
    "id": "lnk_9a8b7c6d5e",
    "slug": "katalog-kopi",
    "short_url": "https://1stdev.link/katalog-kopi",
    "destination_url": "https://1stdev.space/fitur",
    "title": "Katalog Menu Kopi",
    "is_bio_entry": 1,
    "block_type": "featured",
    "clicks": 0
  }
}

GET /api/links Wajib API Key

Ambil seluruh daftar link dan blok bio milik pengguna aktif.

Respon (200 OK):

{
  "status": "success",
  "data": [
    {
      "id": "lnk_9a8b7c6d5e",
      "slug": "katalog-kopi",
      "short_url": "https://1stdev.link/katalog-kopi",
      "destination_url": "https://1stdev.space/fitur",
      "title": "Katalog Menu Kopi",
      "is_bio_entry": 1,
      "block_type": "featured",
      "clicks": 42
    }
  ]
}

PATCH /api/links/{id} Wajib API Key

Perbarui judul, URL tujuan, status aktif, atau tipe blok.

DELETE /api/links/{id} Wajib API Key

Hapus tautan dan bersihkan cache KV secara instan.

GET /api/links/{id}/analytics Wajib API Key

Ambil metrik total klik, grafik kunjungan 30 hari, dan distribusi negara pengunjung.

PUT /api/bio-profile Wajib API Key

Simpan konfigurasi profil bio (display name, handle, bio, avatar, tema, dan efek kartu).

3. Tipe Blok Bio (block_type)

Tipe	Keterangan	Destination URL
`link`	Tombol link biasa	URL https://...
`featured`	Tombol sorotan warna emas 1stdev	URL https://...
`header`	Judul seksi / kategori	`#`
`text`	Paragraf catatan / info	`#`
`divider`	Garis pemisah visual	`#`
`whatsapp`	Tombol WhatsApp instan	`https://wa.me/...`

4. Contoh cURL

curl -X POST https://1stdev.link/api/links \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Daftar Outlet",
    "destination_url": "https://1stdev.space/jelajah",
    "is_bio_entry": true
  }'