Buat Aplikasi Pertama Anda

Application merepresentasikan produk atau layanan yang menggunakan infrastruktur PUGUH. Setiap application mendapatkan API key, akses anggota, dan pelacakan penggunaan sendiri di dalam organisasi.

Memahami Application

Application memberikan lapisan organisasi tambahan:

plaintext

Organization (Acme Corp)
├── Application: Production API
│   ├── API keys for live environment
│   ├── Production member access
│   └── Usage & billing tracking
├── Application: Staging API
│   ├── Test API keys
│   └── Development member access
└── Application: Mobile App
    ├── App-specific API keys
    └── Mobile team access

Membuat Application

Via Dashboard

Navigasi ke dashboard organisasi Anda
Klik "Applications" di sidebar atau header
Klik "New App"
Isi detail aplikasi:

Field	Deskripsi	Contoh
Name	Nama aplikasi yang deskriptif	"Production API"
Slug	Identifier URL	"production-api"
Environment	Tipe environment	Production/Staging/Development
Description	Detail opsional	"Layanan produksi utama"

Klik "Create Application"

Via API

bash

curl -X POST https://api-puguh.arsaka.io/api/v1/applications \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Organization-ID: YOUR_ORGANIZATION_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production API",
    "slug": "production-api",
    "environment": "production",
    "description": "Main production service"
  }'

Environment Application

Kami merekomendasikan penggunaan environment untuk memisahkan kepentingan:

Environment	Tujuan	Karakteristik
Production	Traffic live	Kontrol perubahan ketat, monitoring
Staging	Pengujian pra-produksi	Meniru production, aman untuk testing
Development	Pengembangan aktif	Perubahan sering, eksperimentasi

Warning

Berhati-hatilah saat memodifikasi application production. Selalu uji di staging terlebih dahulu.

Cakupan Application

Resource bisa dicakup pada dua level:

Resource Level Organization

Dibagikan ke semua application dalam organisasi
Berguna untuk pengaturan seluruh perusahaan
Contoh: "Paket billing seluruh organisasi"

Resource Level Application

Terisolasi ke application tertentu
Konfigurasi spesifik per environment
Contoh: "API key staging untuk testing"

Batas Application per Paket

Paket	Maks Application
Free	1
Pro	5
Business	Unlimited
Enterprise	Unlimited

Berpindah Antar Application

Jika organisasi Anda memiliki beberapa application:

Gunakan pemilih application di header (di samping organisasi)
Atau navigasi via Applications di sidebar
URL akan diperbarui untuk mencerminkan application: /app/{organization}/{application}/...

Pengaturan Application

Akses pengaturan application via ikon gear atau halaman settings:

General: Nama, deskripsi, tipe environment
Access: Siapa yang bisa mengakses application ini
API Keys: Kredensial API khusus application
Danger Zone: Hapus application

Caution

Menghapus application akan menghapus semua API key, akses anggota, dan riwayat penggunaan. Tindakan ini tidak dapat dibatalkan.

Praktik Terbaik

1. Pisahkan per Environment

Buat application terpisah untuk production, staging, dan development.

2. Gunakan Nama yang Bermakna

Beri nama application dengan jelas: "Backend API - Production" lebih baik dari "App 1".

3. Batasi Akses Production

Batasi siapa yang bisa memodifikasi pengaturan dan API key application production.

4. Rotasi API Key

Rotasi API key secara berkala, terutama untuk application production.

Langkah Selanjutnya

Dengan application Anda yang sudah dibuat: