Applicazioni

Gli App sono le entità fondamentali in Capgo. Ogni app rappresenta un'applicazione Capacitor unica che puoi gestire e aggiornare tramite la piattaforma. La sezione degli App API ti consente di creare, recuperare, aggiornare e eliminare le configurazioni delle app.

Capire gli App

Un'app in Capgo rappresenta la tua Capacitor applicazione e include:

• ID dell'applicazione: Identificatore univoco per la tua applicazione
• Nome: Nome leggibile da uomo per la tua applicazione
• Icone: Identificatori visivi per l'app nel pannello di controllo
• Configurazione: Impostazioni che controllano come vengono consegnati gli aggiornamenti
• Proprietà: Informazioni di accesso per l'organizzazione e gli utenti
• Statistiche di utilizzo: Metriche sui download e gli aggiornamenti

Pratiche Ottimali

1. Convenzione 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 tue 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 accesso

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 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 URL di percorso: 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"

Sezione intitolata “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.

Corpo della richiesta

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
}

Richiesta di esempio

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

DELETE

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.

Esempio di richiesta

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 errori 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 configurazione dell'App

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

3. Imposta politica di conservazione

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

4. Ottieni Applicazioni 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 Risorse

1. Optimizzazione di ArchiviazioneMonitora l'uso di archiviazione e stabilisci politiche di conservazione adeguate
2. OrganizzazioneGruppa applicazioni correlate sotto una singola organizzazione
3. Controllo di AccessoGestisci quali membri del team possono modificare le impostazioni dell'applicazione
4. Strategia di Backup: Salva le configurazioni e impostazioni dell'applicazione critiche

Continua da Apps

Se stai utilizzando Applicazioni to plan dashboard and API operations, connect it with per pianificare la dashboard e le operazioni di API, connettilo con Panoramica di API per i dettagli di implementazione in Panoramica di __CAPGO_KEEP_0__ Introduzione API Keys Chiavi di API Dispositivi per i dettagli di implementazione in Dispositivi, e Pacchetti per i dettagli di implementazione in Pacchetti.