Dokumentasi API

Autentikasi

Setiap request wajib membawa header x-api-key berisi API key kamu. Buat key di halaman API key. Key berbentuk dsk_ diikuti 32 karakter hex, dan hanya tampil sekali sesudah dibuat. Simpan di tempat yang aman. Kalau key bocor atau hilang, cabut dan buat yang baru.

curl https://serverkit.atlys.ai.id/api/v1/templates \
  -H "x-api-key: dsk_0123456789abcdef0123456789abcdef"

Ganti nilai key di atas dengan API key kamu.

Rate limit

Setiap API key dibatasi 100 request per jam. Selain itu ada batas per alamat IP seperti route internal. Kalau batas terlampaui, server menjawab 429. Pemakaian terakhir tiap key tercatat dan terlihat di halaman API key.

Format response

Semua endpoint mengembalikan JSON dengan amplop yang sama. Berhasil berarti ok: true dan data di data. Gagal berarti ok: false dan pesan di error.

{ "ok": true, "data": { "...": "..." } }
{ "ok": false, "error": "API key tidak valid." }

Daftar template

GET /api/v1/templates mengembalikan ringkasan template: jumlah role, kategori, dan channel, bukan snapshot penuh. Parameter ?q= mencari di nama, tagline, dan tag. Parameter ?tag= menyaring satu tag.

curl "https://serverkit.atlys.ai.id/api/v1/templates?q=komunitas" \
  -H "x-api-key: dsk_0123456789abcdef0123456789abcdef"

{
  "ok": true,
  "data": [
    {
      "id": "komunitas-umum",
      "name": "Komunitas Umum",
      "tagline": "Struktur aman dan rapi untuk komunitas apa pun, lengkap dengan verifikasi dan tiket.",
      "tags": ["community", "umum", "starter"],
      "roles": 4,
      "categories": 5,
      "channels": 15,
      "features": {
        "welcome": true,
        "goodbye": true,
        "verify": true,
        "ticket": true,
        "modlog": true
      }
    }
  ]
}

Buat setup key

POST /api/v1/setups membuat setup key dari template yang sudah ada atau dari snapshot custom. Isi body dengan template_id atau snapshot. Snapshot divalidasi seperti di editor: nama wajib ada, nama channel text wajib lowercase tanpa spasi, dan maksimal 400 channel. Setup key dicatat atas nama pemilik API key.

curl -X POST https://serverkit.atlys.ai.id/api/v1/setups \
  -H "x-api-key: dsk_0123456789abcdef0123456789abcdef" \
  -H "Content-Type: application/json" \
  -d '{ "template_id": "komunitas-umum" }'

{
  "ok": true,
  "data": {
    "key": "a1b2c3d4e5f6",
    "command": "!setup a1b2c3d4e5f6"
  }
}

Jalankan perintah itu di server Discord sebagai pemilik server, sama seperti setup key dari editor.

Cek setup key

GET /api/v1/setups/:key mengembalikan isi setup key: snapshot template lengkap dan waktu pembuatan. Pemilik key tidak dikembalikan.

curl https://serverkit.atlys.ai.id/api/v1/setups/a1b2c3d4e5f6 \
  -H "x-api-key: dsk_0123456789abcdef0123456789abcdef"

{
  "ok": true,
  "data": {
    "key": "a1b2c3d4e5f6",
    "template": {
      "id": "custom-a1b2c3d4e5f6",
      "name": "Server Kecil",
      "tagline": "Contoh template custom.",
      "tags": [],
      "author": "",
      "public": false,
      "roles": [{ "name": "Admin", "permissions": "8" }],
      "categories": [
        {
          "name": "Umum",
          "visibility": "public",
          "channels": [{ "name": "obrolan", "type": "text" }]
        }
      ],
      "features": {
        "welcome": false,
        "goodbye": false,
        "verify": false,
        "ticket": false,
        "modlog": false
      }
    },
    "created_at": "2026-11-06T10:00:00.000Z"
  }
}

Kode error

• 400 Body tidak valid: template tidak ditemukan, template tidak valid, atau template_id dan snapshot sama-sama kosong. Response validasi menyertakan daftar errors.
• 401 Header x-api-key tidak ada atau key tidak valid.
• 404 Setup key tidak ditemukan.
• 429 Rate limit terlampaui. Tunggu sebentar lalu coba lagi.
• 503 API belum tersedia karena migrasi database belum diterapkan.

Playground

Coba endpoint di atas tanpa keluar dari halaman ini. Pilih endpoint, isi parameter, tempel API key, lalu kirim.

curl https://serverkit.atlys.ai.id/api/v1/templates -H "x-api-key: <API_KEY>"