Acceso a la API

Buscador de Series

Documentación

Ayuda y Soporte

Términos y Condiciones
  1. Inicio
  2. /
  3. Estadísticas y Datos
  4. /
  5. API BDE
  6. /
  7. Acceso a la API

Acceso a la API

Para usar la API necesitas una cuenta en la BDE, habilitarla por primera vez desde la página de inicio y obtener tu API Key Token. Puedes acceder a través de la librería Python bcchapi, el Web Service REST o el servicio SOAP.

Para usar la API necesitas una cuenta en la BDE.

  1. Sí, tengo cuenta: continúa con "¿Cómo habilitar la API?".
  2. No, no tengo cuenta: vuelve a la página de inicio de la API, regístrate y luego vuelve a esta sección.

Para poder usar la API, debes habilitarla una única vez desde la página principal. Para ello:

  1. Dirígete a la página inicial de API para Base de Datos Estadísticos.
  2. Inicia sesión con tu email y contraseña de la BDE.
  3. Al iniciar sesión, aparecerá automáticamente el siguiente cuadro de "Habilitación del Servicio" en el centro de la página.
Caja de Habilitación del Servicio API
  1. En este cuadro, acepta los términos y condiciones de uso.
  2. Presiona el botón "Activar el uso de la API".
  3. ¡Listo! Tu acceso a la API ya está habilitado. Ahora obtén tu API Key Token para comenzar a usarla.

El API Key Token es la nueva y recomendada forma de autenticarte en la API BDE. Para obtenerlo:

  1. Ingresa a la página de inicio de la BDE e inicia sesión con tu cuenta.
  2. Dirigete a “Mi Cuenta”.
  3. En la sección “Apikey Token” encontrarás tu API Key Token personal con una vigencia de un año.

Desde esa sección también puedes:

  • Copiar token: copia tu API Key Token para usarlo directamente en tus consultas.
  • Renovar token: genera un nuevo API Key Token si el actual ha expirado.
  • Extender fecha expiración: amplía la vigencia de tu API Key Token actual sin cambiarlo.
Nota: Si eres usuario antiguo o usas el servicio SOAP, puedes continuar accediendo con tu email y contraseña de la BDE.

Una vez que tienes tu API Key Token, úsalo como método de autenticación en Python y en el endpoint REST. El servicio SOAP requiere usuario y contraseña.

Librería bcchapi (Python)

Con el token directamente:

import bcchapi

siete = bcchapi.Siete(token="tu_token")

Endpoint REST (URL)

Incluye el parámetro token en la URL:

https://si3.bcentral.cl/SieteRestWS/SieteRestWS.ashx?token=tu_token&function=GetSeries&timeseries=F073.TCO.PRE.Z.D

Ejemplo para consultar el tipo de cambio USD

Cliente SOAP (C#)

Nota: El servicio SOAP utiliza email y contraseña de la BDE como credenciales.

Define las variables con tus credenciales y úsalas en los métodos:

// Definir credenciales
string usuario = "usuario@ejemplo.com";
string contraseña = "tu_contraseña";
string[] series = new string[] { "F073.TCO.PRE.Z.D" };
string fechaInicio = "2024-01-01";
string fechaFin = "2024-12-31";

// Instanciar cliente SOAP
SieteWS client = new SieteWS();

// Llamar método
var result = client.GetSeries(
    user: usuario,
    password: contraseña,
    seriesIds: series,
    firstDate: fechaInicio,
    lastDate: fechaFin
);

Consulta la sección Documentación donde encontrarás ejemplos completos e información técnica detallada para cada entorno.