SDKs

Bibliotecas cliente oficiales para integrar la API de BanRural AIS en tu aplicación. Descarga el SDK en tu lenguaje preferido y comienza a desarrollar en minutos.

SDKs disponibles:PythonJavaScriptJava

Python

v1.0.0

SDK oficial para Python 3.8+. Incluye tipado completo, manejo de errores y soporte async.

Características

  • Tipado completo con Type Hints
  • Soporte para async/await
  • Manejo automático de tokens OAuth 2.0
  • Retry automático con backoff exponencial
  • Logging integrado

Instalación

pip install banrural-ais-sdk

Inicio Rápido

from banrural_ais import BanRuralClient

# Inicializar cliente
client = BanRuralClient(
    client_id="tu_client_id",
    client_secret="tu_client_secret",
    environment="sandbox"  # o "production"
)

# Listar cuentas
accounts = client.accounts.list()
for account in accounts:
    print(f"{account.account_type}: {account.balance} {account.currency}")

# Obtener transacciones
transactions = client.transactions.list(
    account_id="c7b5b8a0-5b9a-4b0e-8c3b-3e6a1b2a3f4d",
    date_from="2024-01-01",
    date_to="2024-01-31"
)

JavaScript

v1.0.0

SDK para Node.js y navegadores. Compatible con ES Modules y CommonJS.

Características

  • Compatible con Node.js 18+ y navegadores modernos
  • Soporte para Promises y async/await
  • TypeScript definitions incluidas
  • Interceptores para request/response
  • Manejo automático de refresh tokens

Instalación

npm install @banrural/ais-sdk

Inicio Rápido

import { BanRuralClient } from '@banrural/ais-sdk';

// Inicializar cliente
const client = new BanRuralClient({
  clientId: 'tu_client_id',
  clientSecret: 'tu_client_secret',
  environment: 'sandbox' // o 'production'
});

// Listar cuentas
const accounts = await client.accounts.list();
accounts.forEach(account => {
  console.log(`${account.accountType}: ${account.balance} ${account.currency}`);
});

// Obtener transacciones
const transactions = await client.transactions.list({
  accountId: 'c7b5b8a0-5b9a-4b0e-8c3b-3e6a1b2a3f4d',
  dateFrom: '2024-01-01',
  dateTo: '2024-01-31'
});

Java

v1.0.0

SDK para Java 11+. Incluye modelos inmutables y builder patterns.

Características

  • Compatible con Java 11+
  • Modelos inmutables con builders
  • Soporte para CompletableFuture
  • Integración con SLF4J para logging
  • Configuración flexible con properties

Instalación

<dependency>
  <groupId>com.banrural</groupId>
  <artifactId>ais-sdk</artifactId>
  <version>1.0.0</version>
</dependency>

Inicio Rápido

import com.banrural.ais.BanRuralClient;
import com.banrural.ais.model.Account;
import com.banrural.ais.model.Transaction;

// Inicializar cliente
BanRuralClient client = BanRuralClient.builder()
    .clientId("tu_client_id")
    .clientSecret("tu_client_secret")
    .environment(Environment.SANDBOX)
    .build();

// Listar cuentas
List<Account> accounts = client.accounts().list();
for (Account account : accounts) {
    System.out.printf("%s: %.2f %s%n", 
        account.getAccountType(), 
        account.getBalance(), 
        account.getCurrency());
}

// Obtener transacciones
List<Transaction> transactions = client.transactions()
    .list("c7b5b8a0-5b9a-4b0e-8c3b-3e6a1b2a3f4d")
    .dateFrom(LocalDate.of(2024, 1, 1))
    .dateTo(LocalDate.of(2024, 1, 31))
    .execute();

¿Necesitas otro lenguaje?

Si necesitas un SDK en otro lenguaje de programación, puedes generar uno automáticamente a partir de nuestra especificación OpenAPI 3.0.3 usando herramientas como: