Saltar al contenido principal
GET
/
api
/
v1
/
webhook
/
test
Probar la entrega del webhook
curl --request GET \
  --url https://api.benzinga.com/api/v1/webhook/test \
  --header 'Key: <api-key>'
{
  "status": "success"
}

​
Descripción general

Utiliza este endpoint para enviar un webhook de prueba a tu endpoint configurado. Esto te permite comprobar que tu integración de webhooks funciona correctamente antes de empezar a recibir datos de producción en tiempo real.

​
Probar tu integración

Cuando invoques este endpoint, Benzinga enviará una carga útil de webhook de prueba a la URL configurada en destination. Esta entrega de prueba utiliza el mismo formato y la misma lógica de reintentos que las entregas de webhooks en producción.

​
Qué puedes esperar

  1. Respuesta inmediata: La API devuelve un código de estado 200 si se activó correctamente la entrega de prueba.
  2. Payload de prueba: Tu endpoint de webhook recibe un payload de prueba en el mismo formato que los datos de producción.
  3. Encabezados de entrega: La entrega de prueba incluye el encabezado X-BZ-Delivery, igual que las entregas de producción.

​
Verifica tu integración

Usa este endpoint para confirmar:
  • Que tu endpoint de webhook sea accesible públicamente
  • Que tu endpoint pueda procesar correctamente el formato del payload del webhook
  • Que tu endpoint responda con los códigos de estado apropiados (2xx para indicar éxito)
  • Que tu endpoint responda dentro del tiempo de espera de 30 segundos
  • Que tu lógica de idempotencia gestione correctamente el encabezado X-BZ-Delivery y el campo id del payload

​
Mejores prácticas

  • Realiza primero pruebas con endpoints de webhook no productivos
  • Verifica que tu endpoint responda con códigos de estado 200 o 204
  • Confirma que tu sistema de logging y monitoreo captura la entrega de prueba
  • Comprueba que tu lógica de desduplicación funciona con el ID de entrega de prueba
  • Prueba escenarios de error devolviendo temporalmente códigos de estado de error

​
Solución de problemas

​
424 Error de entrega

Si recibes un código de estado 424, significa que el sistema no pudo entregar el payload de prueba a tu endpoint de destino. Causas comunes:
  • La URL de destino no es accesible públicamente
  • El endpoint de destino está devolviendo códigos de estado de error
  • Problemas de conectividad de red
  • Errores de certificado SSL/TLS en el endpoint de destino

​
400 Solicitud no válida

Verifique que todos los parámetros obligatorios se hayan proporcionado y tengan el formato correcto:
  • destination debe ser una URL HTTPS válida
  • version debe ser webhook/v1
  • kind debe ser News/v1
{
  "status": "success"
}

Autorizaciones

​
Key
string
header
requerido

Tu clave de la API de Benzinga

Parámetros de consulta

​
destination
string<uri>
requerido

La URL del endpoint de webhook al que se enviarán los datos de prueba

​
version
enum<string>
predeterminado:webhook/v1
requerido

Versión de la API, actualmente webhook/v1

Opciones disponibles:
webhook/v1
​
kind
enum<string>
predeterminado:News/v1
requerido

Identifica el kind del mensaje. Actualmente: News/v1

Opciones disponibles:
News/v1
​
token
string

Indique el token para transformar los datos para su uso en producción

Respuesta

Éxito - La entrega de prueba del webhook se envió correctamente

​
status
string
Ejemplo:

"success"