API Developer

Documentación API

>>API Developer

Introducción a la API

01-

La API de blackCEX proporciona a los desarrolladores acceso programático a nuestros servicios, permitiendo la integración de funcionalidades de transferencia de dinero, gestión de usuarios y operaciones financieras en aplicaciones de terceros.

Nuestra API RESTful está diseñada siguiendo los estándares más actuales, con endpoints bien documentados y respuestas JSON estructuradas para facilitar su implementación.

Para comenzar a utilizar nuestra API, los desarrolladores deben registrarse en el portal de desarrolladores y solicitar las credenciales de acceso correspondientes.

Autenticación y seguridad

02-

La API de blackCEX utiliza OAuth 2.0 para la autenticación, garantizando un acceso seguro a los recursos. El proceso de autenticación requiere:

  • API Key: Identificador único asignado a cada desarrollador.
  • API Secret: Clave secreta que debe mantenerse segura.
  • Access Token: Token temporal obtenido tras la autenticación.

Todas las solicitudes deben enviarse por HTTPS incluyendo el Access Token en el encabezado:

Authorization: Bearer {access_token}

Los tokens expiran y deben renovarse usando el refresh token entregado en la autenticación inicial.

Endpoints principales

03-

La API de blackCEX ofrece los siguientes endpoints principales:

EndpointMétodoDescripción
/api/v1/usersGET, POSTGestión de usuarios
/api/v1/transfersGET, POSTTransferencias de fondos
/api/v1/accountsGET, PUTInformación de cuentas
/api/v1/ratesGETTasas de cambio
/api/v1/transactionsGETHistorial de transacciones

Puedes consultar más detalles sobre cada endpoint en la documentación oficial del portal para desarrolladores.

Ejemplos de código

04-

A continuación se muestran ejemplos ficticios de uso de la API:

JavaScript (Node.js)

// Código ficticio (no ejecuta llamadas reales)
const API_KEY = 'your_api_key';
const API_SECRET = 'your_api_secret';

function getAccessToken() {
  return "mocked_access_token";
}

function getUserInfo(userId) {
  return {
    id: userId,
    name: "Usuario de prueba",
    email: "user@example.com"
  };
}

Python

# Código ficticio (sin peticiones reales)
def get_access_token():
    return "mocked_access_token"

def create_transfer(sender_id, recipient_id, amount, currency):
    return {
        "status": "success",
        "sender_id": sender_id,
        "recipient_id": recipient_id,
        "amount": amount,
        "currency": currency
    }

Portal de desarrolladores

Acceda a nuestro portal para desarrolladores para obtener más recursos y herramientas.

Ir al portal

Sandbox de pruebas

Pruebe la API en nuestro entorno sandbox antes de implementarla en producción.

Acceder al sandbox