La API de Benzinga usa claves de API (API Keys) para autenticar las solicitudes. Tu clave de API es un identificador único que otorga acceso a datos y funciones específicas según tu suscripción.
Mantén tu clave de API segura. No la compartas en lugares de acceso público como GitHub, código del lado del cliente o comunicaciones no seguras. Si crees que tu clave se ha visto comprometida, ponte en contacto con el equipo de soporte de inmediato.
Puedes ver y administrar tu clave de API en la Consola para desarrolladores de Benzinga.
La API de Benzinga admite dos métodos de autenticación. Recomendamos encarecidamente utilizar el método de encabezado HTTP para aplicaciones en producción, ya que es más seguro y evita que tu clave de API aparezca en los logs de URL.
Para autenticar mediante el encabezado, incluye el encabezado Authorization con el valor token <YOUR_API_KEY>.
Authorization: token <YOUR_API_KEY>
Para pruebas rápidas o cuando no sea posible modificar los encabezados, puedes pasar tu clave de API como un parámetro de consulta llamado token.
https://api.benzinga.com/api/v2/news?token=<YOUR_API_KEY>
A continuación se muestran ejemplos listos para producción para conectarse a la API de Benzinga en lenguajes de uso común.
# Recomendado: Autenticación mediante encabezados
curl -L 'https://api.benzinga.com/api/v2/news?pageSize=1' \
-H 'Authorization: token YOUR_API_KEY' \
-H 'Accept: application/json'
# Alternativa: Parámetro de consulta
curl -L 'https://api.benzinga.com/api/v2/news?pageSize=1&token=YOUR_API_KEY'
Errores de autenticación comunes y cómo resolverlos.
| Código de estado | Mensaje | Posible causa | Solución |
|---|
| 401 | Unauthorized | Clave de API no válida | Verifica que tu clave de API sea correcta y que no haya sido regenerada. Asegúrate de que no se hayan copiado espacios adicionales. |
| 401 | Unauthorized | Falta la clave de API | Asegúrate de que el encabezado Authorization esté formateado correctamente como token <KEY> o de que el parámetro token esté presente. |
| 403 | Forbidden | Permisos insuficientes | Tu clave de API es válida, pero tu plan no incluye acceso al endpoint solicitado. Ponte en contacto con el equipo de ventas o de soporte para actualizar tu plan. |