Aplicaciones

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.

Entendiendo Aplicaciones

Una aplicación en Capgo representa tu Capacitor de aplicación y comprende:

• App ID: Identificador único de tu aplicación
• Nombre: Nombre legible por humanos de tu aplicación
• Iconos: Identificadores visuales para tu aplicación en la consola.
• Configuración: Configuraciones que controlan cómo se entregan las actualizaciones.
• Propiedad: Información de acceso y organización de usuarios.
• Estadísticas de Uso: Métricas sobre instalaciones y actualizaciones.

Prácticas Recomendadas

1. Convención de Nombres: Utiliza nombres claros e identificables para tus aplicaciones.
2. Seguridad: Proteja sus API claves y credenciales de acceso
3. Organización: Agrupe aplicaciones relacionadas bajo la misma organización
4. Monitoreo: Verifique regularmente estadísticas y rendimiento de aplicaciones
5. Backup: Mantenga copias de seguridad de configuración para aplicaciones críticas

Endpoints

GET

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

Recupere información sobre sus aplicaciones.

Parámetros de consulta

• page: Opcional. Número de página para la paginación
• limit: Opcional. Número de resultados por página (por defecto: 50)
• org_idOpcional. Filtra aplicaciones por ID de organización. Si no se proporciona, devuelve aplicaciones de todas las organizaciones a las que el usuario tiene acceso.

Para obtener una aplicación específica:

• Utilice el ID de la aplicación en la ruta de la URL: https://api.capgo.app/app/:app_id

Tipo de respuesta

Nota: last_version se refiere a la última versión (paquete) subida para la aplicación.

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
}

Solicitud de ejemplo

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

Respuesta de ejemplo

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

Crear una nueva aplicación.

Cuerpo de la solicitud

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

Solicitud de ejemplo

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

Respuesta de éxito

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

Actualice una aplicación existente. El ID de la aplicación se especifica en la ruta de la URL.

Cuerpo de la solicitud

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

Solicitud de ejemplo

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

Respuesta de éxito

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

Eliminar

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

Elimine una aplicación y todos los recursos asociados. El ID de la aplicación se especifica en la ruta de la URL. Utilice con precaución extrema ya que esta acción no se puede deshacer.

Solicitud de ejemplo

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

Respuesta de éxito

{
  "status": "ok"
}

Gestión de errores

Escenarios de errores comunes y sus respuestas:

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

Casos de uso comunes

1. Crear Nueva Aplicación

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

2. Actualizar Configuración de Aplicación

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

3. Establecer Política de Retención

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

4. Ventana de Terminal

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

Sección titulada “Gestión de Recursos”

1. Optimización de almacenamiento: Supervise el uso de almacenamiento y establezca políticas de retención adecuadas
2. Organización: Agrupe aplicaciones relacionadas bajo una sola organización
3. Control de accesoAdministra qué miembros del equipo pueden modificar ajustes de la aplicación
4. Estrategia de respaldo: Resguarde las configuraciones y ajustes críticos de la aplicación

Sigue adelante desde Aplicaciones

Si estás utilizando Aplicaciones para planificar la consola y API operaciones, conecte con API Vista General para los detalles de implementación en API Vista General, Introducción para los detalles de implementación en Introducción, API Claves para los detalles de implementación en API Claves, Dispositivos para los detalles de implementación en dispositivos Bundles para los detalles de implementación en los Paquetes.