Aplikasi

Aplikasi adalah entitas dasar di Capgo. Setiap aplikasi mewakili aplikasi unik Capacitor yang dapat Anda kelola dan update melalui platform. Fitur Apps API memungkinkan Anda untuk membuat, mengambil, memperbarui, dan menghapus konfigurasi aplikasi.

Paham Aplikasi

Aplikasi di Capgo mewakili aplikasi Capacitor Anda dan termasuk:

• ID Aplikasi: Identifikasi unik untuk aplikasi Anda
• Nama: Nama yang dapat dibaca manusia dari aplikasi Anda
• Ikon: Identifikasi visual aplikasi Anda di dashboard
• Konfigurasi: Pengaturan yang mengontrol bagaimana update disampaikan
• Pemilik: Informasi akses organisasi dan pengguna
• Statistik Penggunaan: Metrik tentang instalasi dan update

Praktik Terbaik

1. Konvensi Nama: Gunakan nama yang jelas dan dapat diidentifikasi untuk aplikasi Anda
2. Keamanan: Protect your API keys and access credentials
3. : Lindungi kunci dan kredit akses __CAPGO_KEEP_0__ AndaOrganisasi
4. : Kelompokkan aplikasi terkait di bawah organisasi yang samaPantauan
5. : Periksa statistik aplikasi dan kinerja secara teraturBackup Data

Endpoint

GET

https://api.capgo.app/app/

Retriev informasi tentang aplikasi Anda.

Parameter Pencarian

• page: Opsional. Nomor halaman untuk pagination
• limit: Opsional. Jumlah hasil per halaman (default: 50)
• org_id: Opsional. Filter aplikasi berdasarkan ID organisasi. Jika tidak disediakan, mengembalikan aplikasi dari semua organisasi yang diakses pengguna

Untuk mendapatkan aplikasi tertentu:

• Gunakan ID aplikasi dalam URL path: https://api.capgo.app/app/:app_id

Tipe Respon

Perlu diingat: last_version merujuk pada bundle terakhir (versi) yang diunggah untuk aplikasi.

interface App {
  app_id: string
  block_provider_infra_requests: boolean
  created_at: string | null
  default_upload_channel: string
  icon_url: string
  id: string | null
  last_version: string | null // last bundle (version) name
  name: string | null
  owner_org: string
  retention: number
  transfer_history: Json[] | null
  updated_at: string | null
  user_id: string | null
}

Contoh Permintaan

# Get all apps
curl -H "authorization: your-api-key" \
  "https://api.capgo.app/app/"

# Get apps from a specific organization
curl -H "authorization: your-api-key" \
  "https://api.capgo.app/app/?org_id=046a36ac-e03c-4590-9257-bd6c9dba9ee8"

# Get specific app
curl -H "authorization: your-api-key" \
  "https://api.capgo.app/app/com.demo.app"

Contoh Respon

{
  "data": [
    {
      "block_provider_infra_requests": true,
      "app_id": "com.demo.app",
      "created_at": "2024-01-01T00:00:00Z",
      "default_upload_channel": "dev",
      "icon_url": "https://example.com/icon.png",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "last_version": "1.0.0",
      "name": "Demo App",
      "owner_org": "046a36ac-e03c-4590-9257-bd6c9dba9ee8",
      "retention": 2592000,
      "transfer_history": null,
      "updated_at": "2024-01-01T00:00:00Z",
      "user_id": "6aa76066-55ef-4238-ade6-0b32334a4097"
    }
  ]
}

Mengirimkan

https://api.capgo.app/app/

Buat aplikasi baru.

Badan Permintaan

interface CreateApp {
  app_id: string
  name: string
  icon?: string
  owner_org: string
}

Contoh Permintaan

# Create new app
curl -X POST \
  -H "authorization: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My New App",
    "app_id": "com.demo.myapp", // this id is unique in Capgo This cannot be reused by any account.
    "icon": "https://example.com/icon.png",
    "owner_org": "046a36ac-e03c-4590-9257-bd6c9dba9ee8"
  }' \
  https://api.capgo.app/app/

Respons Sukses

{
  "block_provider_infra_requests": true,
  "app_id": "My New App",
  "created_at": "2024-01-01T00:00:00Z",
  "default_upload_channel": "dev",
  "icon_url": "https://example.com/icon.png",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My New App",
  "owner_org": "046a36ac-e03c-4590-9257-bd6c9dba9ee8",
  "retention": 2592000,
  "updated_at": "2024-01-01T00:00:00Z"
}

PUT

https://api.capgo.app/app/:app_id

Perbarui aplikasi yang sudah ada. ID aplikasi ditentukan dalam jalur URL.

Tubuh Permintaan

interface UpdateApp {
  block_provider_infra_requests?: boolean
  name?: string
  icon?: string
  retention?: number
}

Contoh Permintaan

curl -X PUT \
  -H "authorization: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "block_provider_infra_requests": true,
    "name": "Updated App Name",
    "icon": "https://example.com/updated-icon.png",
    "retention": 45
  }' \
  https://api.capgo.app/app/com.demo.app

Respons Sukses

{
  "app_id": "com.demo.app",
  "created_at": "2024-01-01T00:00:00Z",
  "default_upload_channel": "dev",
  "block_provider_infra_requests": true,
  "icon_url": "https://example.com/updated-icon.png",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Updated App Name",
  "owner_org": "046a36ac-e03c-4590-9257-bd6c9dba9ee8",
  "retention": 45,
  "updated_at": "2024-01-01T00:00:00Z"
}

Hapus

https://api.capgo.app/app/:app_id

Hapus Aplikasi dan Sumber Daya yang Terkait. ID Aplikasi ditentukan dalam Jalur URL. Gunakan dengan Berhati-Hati Karena Tindakan Ini Tidak Dapat Dibatalkan.

Contoh Permintaan

curl -X DELETE \
  -H "authorization: your-api-key" \
  https://api.capgo.app/app/com.demo.app

Respon Berhasil

{
  "status": "ok"
}

Pengelolaan Kesalahan

Skenario kesalahan umum dan responsnya:

// App not found
{
  "error": "App not found",
  "status": "KO"
}

// Duplicate custom ID
{
  "error": "Custom ID already in use",
  "status": "KO"
}

// Invalid parameters
{
  "error": "Invalid app configuration",
  "status": "KO"
}

// Permission denied
{
  "error": "Insufficient permissions to manage app",
  "status": "KO"
}

// Organization access denied
{
  "status": "You do not have access to this organization"
}

Penggunaan Umum

1. Buat Aplikasi Baru

// Set up a new app
{
  "name": "Production App",
  "owner_org": "046a36ac-e03c-4590-9257-bd6c9dba9ee8"
}

2. Perbarui Konfigurasi Aplikasi

// Change app name and icon
{
  "name": "Rebranded App Name",
  "icon": "https://example.com/new-icon.png"
}

3. Atur Kebijakan Retensi

// Configure automatic bundle cleanup
{
  "retention": 30 // Keep bundles for 30 days
}

4. Aplikasi oleh Organisasi

# List all apps in a specific organization
curl -H "authorization: your-api-key" \
  "https://api.capgo.app/app/?org_id=046a36ac-e03c-4590-9257-bd6c9dba9ee8"

Pengelolaan Sumber Daya

1. Optimasi Penyimpanan: Pantau penggunaan penyimpanan dan atur kebijakan retensi yang tepat
2. Organisasi: Kelompokkan aplikasi terkait di bawah organisasi tunggal
3. Pengendalian Akses: Kelola anggota tim mana yang dapat mengubah pengaturan aplikasi
4. Rencana Cadangan: Kembalikan konfigurasi dan pengaturan aplikasi yang kritis

Teruskan dari Aplikasi

Jika Anda menggunakan Aplikasi to plan dashboard and API operations, connect it with untuk merencanakan dashboard dan operasi API, hubungkannya dengan Ringkasan API untuk detail implementasi di Ringkasan __CAPGO_KEEP_0__ Intro API Keys Kunci API Perangkat untuk detail implementasi di Perangkat, dan Paket untuk detail implementasi di Paket.