Applicazioni

Apps are the foundational entities in Capgo. Each app represents a unique Capacitor application that you can manage and update through the platform. The Apps API allows you to create, retrieve, update, and delete app configurations.

Capire gli App

An app in Capgo represents your Capacitor application and includes:

• ID App: Identificatore univoco per la tua applicazione
• Nome: Nome leggibile dell'applicazione
• Icone: Identificatori visivi per l'app nel dashboard
• Configurazione: Impostazioni che controllano come vengono consegnate le aggiornamenti
• Proprietà: Informazioni di accesso dell'organizzazione e degli utenti
• Statistiche di Utilizzo: Metriche sui download e gli aggiornamenti

Pratiche Raccomandate

1. Convenzioni di Nominazione: Utilizza nomi chiari e identificabili per le tue app
2. Sicurezza: Proteggi le tue API chiavi e le credenziali di accesso
3. Organizzazione: Raggruppa le app correlate sotto la stessa organizzazione
4. Monitoraggio: Controlla regolarmente le statistiche e le prestazioni delle app
5. Backup: Mantieni backup delle configurazioni per le app critiche

Punti di Fine

Esegui GET

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

Recupera informazioni sui tuoi app.

Parametri di query

• page: Opzionale. Numero di pagina per la paginazione
• limit: Opzionale. Numero di risultati per pagina (predefinito: 50)
• org_id: Opzionale. Filtra le app per l'ID dell'organizzazione. Se non fornito, restituisce le app da tutte le organizzazioni di cui l'utente ha accesso

Per ottenere una specifica app:

• Utilizza l'ID dell'app nella path URL: https://api.capgo.app/app/:app_id

Tipo di Risposta

Nota: last_version si riferisce all'ultima bundle (versione) caricata per l'applicazione.

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
}

Esempio di richiesta

# 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"

Esempio di risposta

{
  "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"
    }
  ]
}

POST

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

Crea una nuova app.

Richiesta Body

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

Esempio di richiesta

# 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/

Risposta di successo

{
  "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

Aggiorna un'app esistente. L'ID dell'app è specificato nella path della URL.

Corpo della richiesta

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

Esempio di richiesta

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

Risposta di successo

{
  "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"
}

Cancella

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

Elimina un'app e tutte le relative risorse. L'ID dell'app è specificato nella path della URL. Utilizzare con estrema cautela poiché questa azione non può essere annullata.

Richiesta di esempio

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

Risposta di successo

{
  "status": "ok"
}

Gestione degli errori

Scenari di errore comuni e le loro risposte:

// 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"
}

Casi d'uso comuni

1. Crea nuova app

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

2. Aggiorna la configurazione dell'app

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

3. Imposta la politica di conservazione

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

4. Ottieni app per organizzazione

# 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"

Gestione delle risorse

1. Optimizzazione dello storage: Monitorare l'uso dello storage e impostare politiche di conservazione adeguate
2. Organizzazione: Raggruppare le app correlate sotto una singola organizzazione
3. Controllo degli accessi: Gestire quali membri del team possono modificare le impostazioni dell'app
4. Strategia di backup: Eseguire backup delle configurazioni e impostazioni dell'app critiche

Continua da Apps

Se stai utilizzando Gli App per pianificare il dashboard e le operazioni di API API Overview API Overview per i dettagli di implementazione in __CAPGO_KEEP_0__ Overview Introduzione API Keys API Keys per i dettagli di implementazione in __CAPGO_KEEP_0__ Keys Dispositivi Pacchetti per i dettagli di implementazione in Pacchetti.