Plataforma de Desarrollo

Centro de Desarrolladores

Construye el futuro con nuestras APIs abiertas y SDKs. Integra virtex en cualquier stack en minutos.

Comenzar

Construye en 3 Pasos

De cero a tu primera llamada API en menos de 5 minutos.

  1. 1
    Crea una Cuenta

    Regístrate en una cuenta de desarrollador de virtex y navega a la sección API.

  2. 2
    Genera Tu API Key

    Crea una nueva clave API en el panel. Mantenla segura — trátala como una contraseña.

  3. 3
    Realiza Tu Primera Llamada

    Usa nuestros SDKs o llama directamente a la API REST. Verifica la consola para una respuesta exitosa.

typescript
import { VirtexClient } from '@virtex/sdk';

const client = new VirtexClient({ apiKey: 'vtx_live_51M...' });

// Create an invoice
const invoice = await client.invoices.create({
  customer: 'cus_123',
  amount: 2500,
  currency: 'usd',
  items: [{ description: 'Consulting Services', quantity: 5 }],
});

console.log(invoice.id); // inv_98765
Seguridad

Autenticación

Todas las solicitudes API se autentican mediante claves API en el encabezado Authorization.

API Key: Se pasa como token Bearer en el encabezado Authorization.

TLS 1.3: Todas las conexiones deben usar HTTPS. El HTTP plano es rechazado.

Vencimiento del token: Las claves no caducan pero pueden revocarse en cualquier momento.

Obtener API Key
typescript
// Bearer token authentication
const response = await fetch('https://api.virtex.com/v1/invoices', {
  headers: {
    'Authorization': 'Bearer vtx_live_51M...',
    'Content-Type': 'application/json',
  },
});
REST API

Referencia de Endpoints

Todos los endpoints son RESTful y devuelven JSON. URL base: https://api.jsl.technology/v1

GET/v1/invoicesListar todas las facturas
POST/v1/invoicesCrear nueva factura
GET/v1/customersListar todos los clientes
POST/v1/customersCrear nuevo cliente
GET/v1/productsListar todos los productos
DELETE/v1/invoices/{id}Eliminar una factura

Todas las operaciones de escritura requieren el scope write:all.

Eventos en Tiempo Real

Webhooks

Suscríbete a eventos en tiempo real de virtex. Enviaremos un payload JSON a tu endpoint.

  • invoice.paid
  • invoice.overdue
  • customer.created
  • payment.failed
  • product.updated
  • subscription.renewed
typescript
// Handle incoming webhooks
app.post('/webhooks/virtex', (req, res) => {
  const event = VirtexClient.constructEvent(
    req.body,
    req.headers['virtex-signature'],
    process.env.WEBHOOK_SECRET
  );

  switch (event.type) {
    case 'invoice.paid':
      console.log('Invoice paid:', event.data.id);
      break;
    case 'customer.created':
      syncToYourCRM(event.data);
      break;
  }
  res.sendStatus(200);
});
Librerías Cliente

SDKs Oficiales

Nuestras librerías oficiales abstraen la autenticación, reintentos y manejo de errores.

JavaScript / Node.js

@virtex/sdk
bash
npm install @virtex/sdk

Python

virtex-python
bash
pip install virtex

.NET / C#

Virtex.NET
bash
dotnet add package Virtex

Java

io.virtex:virtex-java
bash
maven: io.virtex:virtex-java

Límites de Tasa

Los límites son por clave API por minuto.

  • Gratuito: 60 req/min100 req/min
  • Pro: 600 req/min1000 req/min
  • Empresarial: Sin límiteUnlimited

¿Necesitas Ayuda?

Nuestro equipo de soporte para desarrolladores está disponible lunes a viernes, 9am–6pm EST.

Empieza a Construir

Únete a Nuestra Comunidad de Desarrolladores

Accede a documentación, SDKs y soporte para integrar virtex en tu stack.

Contactar Ahora