Inicio Rápido del SDK de Python

Este artículo proporciona un inicio rápido para operaciones comunes usando el SDK de Python. Aprenderás cómo instalar el SDK, configurar las credenciales de acceso y realizar operaciones básicas como recuperar la información de actualización más reciente.

Notas

• Cuando hagas solicitudes usando el SDK de Python, necesitas inicializar una instancia de Client. Este artículo crea un Client cargando configuraciones predeterminadas. Para más opciones de configuración sobre el cliente, por favor consulta Configuración del Cliente.

Requisitos Previos

• Cuenta de upgradeLink registrada.
• AccessKey y AccessSecret obtenidos.
• Estrategia de actualización de aplicación URL configurada.

Obtener Credenciales

Instalar SDK de Python

• Por favor instala primero el entorno de compilación y ejecución de Python. Verifica si Python está instalado correctamente con el siguiente comando:

  python --version

Si actualmente no hay un entorno de compilación y ejecución de Python adecuado, por favor consulta Instalación de Python para descargar e instalar.

• Ejecuta el siguiente comando para instalar el paquete de código del SDK de Python.

pip install upgradelink-api-python

• Usa el siguiente código para importar el paquete de código del SDK de Python.

import upgradelink_api_python

Uso Rápido

El siguiente programa de muestra demuestra cómo inicializar un Client y recuperar la información de actualización más reciente para una aplicación URL.

Obtener Información de Actualización Más Reciente para Aplicación URL

from upgradelink_api_python import models as upgrade_link_models
from upgradelink_api_python.client import Client

def main():
    # Crear objeto de configuración
    config = upgrade_link_models.Config(
        access_key="mui2W50H1j-OC4xD6PgQag",  # Clave de ejemplo, por favor reemplázala con tu clave real
        access_secret="PEbdHFGC0uO_Pch7XWBQTMsFRxKPQAM2565eP8LJ3gc",  # Clave de ejemplo, por favor reemplázala con tu clave real
        protocol="HTTPS",
        endpoint="api.upgrade.toolsetlink.com"
    )
    
    # Crear cliente
    client = Client(config)
    
    # Establecer parámetros de la solicitud
    url_key = "uJ47NPeT7qjLa1gL3sVHqw"  # Identificador único para la aplicación URL
    version_code = 1  # Número de versión actual de la aplicación
    appoint_version_code = 0  # Número de versión especificado, 0 indica la versión más reciente
    dev_model_key = ""  # Identificador del modelo del dispositivo, opcional
    dev_key = ""  # Identificador del dispositivo, opcional
    
    # Construir objeto de solicitud
    request = upgrade_link_models.UrlUpgradeRequest(
        url_key=url_key,
        version_code=version_code,
        appoint_version_code=appoint_version_code,
        dev_model_key=dev_model_key,
        dev_key=dev_key
    )
    
    try:
        # Llamar a la interfaz API
        response = client.url_upgrade(request)
        
        # Procesar resultado de la respuesta
        if response.code == 200:
            print("¡Solicitud exitosa!")
            print(f"Mensaje: {response.msg}")
            print(f"ID de Rastreo: {response.trace_id}")
            
            # Procesar datos de actualización
            if response.data:
                data = response.data
                print("\nInformación de Actualización:")
                print(f"URL Key: {data.url_key}")
                print(f"Nombre de Versión: {data.version_name}")
                print(f"Código de Versión: {data.version_code}")
                print(f"Ruta URL: {data.url_path}")
                print(f"Tipo de Actualización: {data.upgrade_type}")  # 1: Actualización forzada, 2: Actualización recomendada, 3: Actualización opcional
                print(f"Contenido del Mensaje de Actualización: {data.prompt_upgrade_content}")
                
                # Manejar diferentes tipos de actualización
                if data.upgrade_type == 1:
                    print("\nEsta es una actualización forzada. Por favor actualiza la aplicación inmediatamente.")
                    # Ejecutar lógica de actualización forzada
                elif data.upgrade_type == 2:
                    print("\nEsta es una actualización recomendada. Se recomienda que los usuarios actualicen la aplicación.")
                    # Ejecutar lógica de actualización recomendada
                elif data.upgrade_type == 3:
                    print("\nEsta es una actualización opcional. Los usuarios pueden elegir si actualizar o no.")
                    # Ejecutar lógica de actualización opcional
        else:
            print(f"Solicitud fallida, código de error: {response.code}")
            print(f"Mensaje de error: {response.msg}")
            print(f"ID de Rastreo: {response.trace_id}")
            
    except Exception as e:
        print(f"Se produjo un error al llamar a la API: {e}")

if __name__ == "__main__":
    main()