SDK .NET

El SDK .NET de Dinaup es la familia de módulos para construir aplicaciones .NET sobre la plataforma. Todo viaja dentro del paquete principal Dinaup: cada módulo cubre un aspecto y se usa de forma independiente.

Instalación

dotnet add package Dinaup

Para trabajar tipado contra tu modelo de datos (secciones, informes, documentos), añade tu biblioteca MyDinaup.

Módulos

Módulos auxiliares

Piezas más pequeñas que también entran con el paquete Dinaup.

Login de empleados (authclient)

DinaupAuthClient autentica credenciales de empleado contra auth.dinaup.com (login tipo SecureLink). Una sola llamada:

using Dinaup.Auth;

var auth = new DinaupAuthClient();
var res = await auth.LoginAsync(email, password);

if (res != null)
{
    // res trae la keyword de conexión del tenant y los datos del usuario
}

Aplica límite de intentos (4 por minuto y correo). Devuelve null si las credenciales fallan.

Integración de apps externas (myapps)

Para apps externas que operan sobre un tenant:

• MyAppClient: hereda de DinaupClientC (acceso completo a la API) y ejecuta informes con ExecuteReport, resolviendo la sesión desde la configuración de la app externa.
• MyAppKVClient: almacén clave-valor distribuido (SetKVAsync/GetKVAsync, hasta 10 MB por valor). Implementa IHealthCheck.

Excepciones (exceptions)

El SDK lanza excepciones tipadas del namespace Dinaup.Exceptions: ClientNotInitializedException, APIConnectionException, InvalidAPIResponseException, TimeoutException, APIOperationException, RetryLimitExceeded, APIRequestException. Cáptualas para distinguir un fallo de conexión de una respuesta inválida o un timeout.

Cultura y zona horaria (cultureservice)

CultureService (interfaz ICultureService) formatea fechas, importes y decimales según la cultura y la zona horaria del usuario, y convierte entre UTC y hora local (ToLocal, ToUtc, ToStringMoney, ToLocalFriendlyDate). Detecta la cultura del header Accept-Language; los valores por defecto (es-ES, Europe/Madrid) se ajustan con CultureServiceOptions.

MyDinaup

Dinaup es flexible: cada empresa tiene su propio modelo de datos. Para trabajarlo tipado necesitas tu biblioteca MyDinaup, con los nombres reales de tus secciones, informes y documentos.

# Modelo genérico Ready to Go (compatible entre empresas)
dotnet add package ReadyToGo.MyDinaup

Qué contiene, cómo se genera y cómo se usa, en MyDinaup.