API BCE ejemplos: llamadas en cURL, JavaScript y Python
Ejemplos de API BCE listos para copiar: ficha de empresa, búsqueda por nombre o dirección, validación de IVA en VIES y códigos NACE, en tres lenguajes.
Copy-paste recipes for the most common tasks. Every call is authenticated (see Authentication).
Fetch an enterprise#
curl https://companybelgium.be/api/v2/enterprise/1033.022.383 \
-H "X-API-Key: $API_BCE_KEY" \
-H "X-API-Secret: $API_BCE_SECRET"Search by company name#
curl "https://companybelgium.be/api/v2/denominations?q=espero&limit=5" \
-H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"Search by address#
curl "https://companybelgium.be/api/v2/search/address?postalCode=1080&street=Colonne" \
-H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"Validate an EU VAT number#
curl "https://companybelgium.be/api/v2/vat/BE1033022383" \
-H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"Search NACE activity codes#
curl "https://companybelgium.be/api/v2/naces?q=programmation&version=2008&limit=10" \
-H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"Prefer to explore interactively? Open the API Playground and fire real requests from your browser.
Combinar los ejemplos de API BCE en flujos reales#
Cada ejemplo resuelve una tarea aislada. En producción, sin embargo, suelen encadenarse. Un formulario de alta de cliente es un buen caso. Primero, el usuario escribe unas letras y llamas a /denominations para sugerir nombres. Luego, cuando elige una empresa, recuperas su ficha con el número BCE. Por último, validas su IVA con /vat antes de guardar el cliente.
Del mismo modo, una herramienta de prospección combina la búsqueda por dirección y los códigos NACE. Así encuentras las empresas de una calle y luego las filtras por actividad.
Adaptar los ejemplos a tu código#
- Sustituye las claves escritas en el ejemplo por variables de entorno.
- Añade un tiempo de espera máximo a cada solicitud HTTP.
- Gestiona el caso
success: falsey lee el mensaje deerror. - En el autocompletado, espera al menos 2 caracteres: es el mínimo de
q. - Limita las sugerencias con
limit(20 por defecto, 50 como máximo).
Errores frecuentes al copiar ejemplos#
El primer error es lanzar una solicitud por cada tecla en el autocompletado. Con un plan de 300 solicitudes por hora, la cuota se agota rápido. Por eso conviene esperar una breve pausa del usuario antes de llamar. Otro error es ejecutar el ejemplo JavaScript en el navegador con el secreto incluido. Ejecútalo, más bien, en Node.js o en tu servidor. Además, no olvides codificar los parámetros de la URL, sobre todo con calles que contienen acentos.
Del ejemplo al servicio interno
En muchos equipos, los ejemplos acaban en un pequeño servicio interno que centraliza las llamadas. Es una buena idea. Primero, ese servicio guarda las credenciales en un solo lugar. Luego aplica la misma caché, los mismos reintentos y el mismo registro a todas las consultas. Así tus aplicaciones de facturación, CRM o compras no repiten esa lógica. Además, puedes exponer solo los campos que cada aplicación necesita. Por último, el servicio puede leer las cabeceras X-RateLimit y frenar las llamadas antes de llegar a un 429.
Preguntas frecuentes sobre API BCE y los ejemplos#
¿En qué lenguajes están los ejemplos de API BCE?
En cURL, JavaScript y Python. Como la API es REST y JSON, el mismo patrón se adapta a cualquier lenguaje con un cliente HTTP.
¿Puedo probar los ejemplos sin cuenta?
Sí, en el playground con la clave de demo. Está limitada a 15 solicitudes cada 10 minutos y solo a datos públicos del registro.
¿Los ejemplos funcionan con el modo de prueba?
Sí. Cambia la URL base por https://api-bce.be/test/v2 y usa tus claves de prueba con los números ficticios.