Documentación / Playground de la API

API BCE sandbox: probar la API en el navegador sin registro

Sandbox de API BCE: envía solicitudes reales desde tu navegador con la clave de demo, datos de prueba ficticios o tu propia clave, con respuesta y tiempo.

Envía solicitudes reales a la API v2 en directo. Sin cuenta, usa la clave de demostración; con cuenta, pega tu propia clave.

Las solicitudes de demo pasan por api-bce.be con una clave compartida: 15 solicitudes cada 10 minutos, solo datos públicos del registro.

GET /enterprise/{num}
cURL
curl "" \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"

Usar el playground de API BCE antes de programar#

El playground responde a preguntas rápidas sin escribir código. Por ejemplo, un jefe de producto comprueba qué campos devuelve la ficha de una empresa real. Del mismo modo, un desarrollador verifica la respuesta exacta antes de diseñar su modelo de datos. Así evitas suposiciones sobre nombres de campos o formatos. Además, el tiempo de respuesta y la cuota restante aparecen con cada solicitud.

Tienes tres modos. Los datos de prueba usan la API de prueba con empresas ficticias. La clave de demo, por su parte, no requiere registro. Por último, puedes pegar tu propia clave para probar cualquier endpoint.

Qué modo elegir#

  • Datos de prueba: para ver una quiebra con 0999.999.229 o un 429 con 0999.999.526.
  • Clave de demo: para una primera visita, con 15 solicitudes cada 10 minutos y solo datos públicos.
  • Tu clave: para los endpoints que exigen tu propia clave.
  • Tu clave también: para ver tu cuota restante real tras cada llamada.

Precauciones#

Tu clave y tu secreto se quedan en la pestaña, en sessionStorage, y solo viajan a la API para la solicitud en curso. Sin embargo, evita usar tu clave de producción en un ordenador compartido. Prefiere una clave de prueba o una clave dedicada. Además, recuerda que cada solicitud con tu clave real cuenta en tu cuota. Por eso conviene usar los datos de prueba para explorar los casos de error.

Del playground a tu código

El playground es también una herramienta de diagnóstico. Cuando tu código recibe una respuesta extraña, repite la misma solicitud en el playground con tu clave. Si la respuesta coincide, el problema está en tu lectura de los datos. En cambio, si difiere, revisa las cabeceras o los parámetros que envía tu código. Además, el tiempo mostrado te da una referencia de latencia. Por último, comparte con tu equipo el endpoint y los parámetros probados, nunca tu clave.

Preguntas frecuentes sobre API BCE y el playground#

¿Necesito una cuenta para usar el playground?

No. La clave de demo funciona sin registro, con 15 solicitudes cada 10 minutos y datos públicos del registro.

¿Las solicitudes del playground llegan a API BCE real?

Sí, con la clave de demo o con tu clave llegan a la API v2 real. En el modo de datos de prueba, en cambio, llegan a la API de prueba.

¿Se guarda mi clave en algún sitio?

No. Según la documentación del playground, la clave y el secreto se quedan en tu pestaña y nunca se conservan en el servidor.