馃毀 La documentacion de Bloque est谩 en desarrollo
close
Bloque Docs
  • Espa帽ol

      • Primeros Pasos

      Comienza a utilizar Bloque SDK en minutos.

      Instalaci贸n

      Instala el SDK usando tu gestor de paquetes preferido:

      :::code-group

      bun add @bloque/sdk
      npm install @bloque/sdk
      yarn add @bloque/sdk
      pnpm add @bloque/sdk

      :::

      Clave API

      Para usar el SDK de Bloque, necesitar谩s una clave API. Puedes obtenerla desde el Panel de Control de Bloque.

      Seguridad

      Nunca expongas tu clave API en c贸digo del lado del cliente. Siempre utiliza variables de entorno y mant茅n tus claves seguras.

      Inicializar el SDK

      Crea una instancia del SDK con tu clave API y modo:

      import { SDK } from '@bloque/sdk';

const bloque = new SDK({
  origin: 'your-origin',
  auth: {
    type: 'apiKey',
    apiKey: process.env.BLOQUE_API_KEY!,
  },
  mode: 'production', // or 'sandbox' for testing
});

      Opciones de Configuraci贸n

      Opci贸nTipoRequeridoDescripci贸n
      apiKeystringS铆Tu clave API de Bloque
      mode'production' | 'sandbox'S铆Modo de entorno

      Modos

      • sandbox: Para pruebas y desarrollo. Sin transacciones reales.
      • production: Para operaciones en vivo con datos reales.

      Tu Primera Solicitud

      Vamos a crear una tarjeta virtual:

      import { SDK } from '@bloque/sdk';

const bloque = new SDK({
  apiKey: process.env.BLOQUE_API_KEY!,
  mode: 'production',
});

async function createCard() {
  try {
    const card = await bloque.accounts.card.create({
      urn: 'did:bloque:user:123e4567',
      name: 'My First Card',
    });

    console.log('Card created successfully!');
    console.log('URN:', card.urn);
    console.log('Last four:', card.lastFour);
    console.log('Status:', card.status);
    console.log('Details URL:', card.detailsUrl);
  } catch (error) {
    console.error('Error creating card:', error);
  }
}

createCard();

      Manejo de Errores

      Siempre envuelve las llamadas del SDK en bloques try-catch para manejar errores elegantemente:

      try {
  const card = await bloque.accounts.card.create({
    urn: 'did:bloque:user:123',
    name: 'My Card',
  });
  // Success
} catch (error) {
  if (error instanceof Error) {
    console.error('Failed:', error.message);
  }
  // Handle error
}

      Soporte de TypeScript

      El SDK est谩 construido con TypeScript y proporciona seguridad de tipos completa:

      import type { CardAccount, CreateCardParams } from '@bloque/sdk/accounts';

// Type-safe parameters
const params: CreateCardParams = {
  urn: 'did:bloque:user:123',
  name: 'My Card',
};

// Type-safe response
const card: CardAccount = await bloque.accounts.card.create(params);

      Variables de Entorno

      Usa variables de entorno para almacenar tu clave API de forma segura:

      # .env
BLOQUE_API_KEY=your_api_key_here
BLOQUE_MODE=sandbox

      Luego c谩rgalas en tu aplicaci贸n:

      import { SDK } from '@bloque/sdk';
import 'dotenv/config'; // or your preferred env loader

const bloque = new SDK({
  origin: 'your-origin',
  auth: {
    type: 'apiKey',
    apiKey: process.env.BLOQUE_API_KEY!,
  },
  mode: process.env.BLOQUE_MODE as 'production' | 'sandbox',
});

      Pr贸ximos Pasos