Skip to main content
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

Use este endpoint para activar el envío de un webhook de prueba a su endpoint configurado. Esto le permite verificar que su integración de webhook funciona correctamente antes de recibir datos de producción en tiempo real.

​
Prueba de tu integración

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

​
Qué esperar

  1. Respuesta inmediata: La API devuelve un código de estado 200 si la entrega de prueba se activó correctamente.
  2. Carga útil de prueba: Tu endpoint de webhook recibe una carga útil 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, al igual que las entregas de producción.

​
Verifica tu integración

Usa este endpoint para confirmar:
  • Que tu endpoint de webhook es accesible públicamente
  • Que tu endpoint puede procesar correctamente el formato del payload del webhook
  • Que tu endpoint responde con los códigos de estado adecuados (2xx para indicar éxito)
  • Que tu endpoint responde dentro del límite de tiempo de 30 segundos
  • Que tu lógica de idempotencia maneja correctamente el encabezado X-BZ-Delivery y el campo id del payload

​
Mejores prácticas

  • Prueba primero con endpoints de webhook que no sean de producción
  • Verifica que tu endpoint responda con códigos de estado 200 o 204
  • Confirma que tu logging y monitoreo capturen la entrega de prueba
  • Comprueba que tu lógica de deduplicación funcione con el ID de entrega de prueba
  • Prueba escenarios de error devolviendo temporalmente códigos de estado de error

​
Resolución de problemas

​
424 Error de entrega

Si recibes un código de estado 424, 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

Verifica que todos los parámetros obligatorios se proporcionen y tengan el formato correcto:
  • destination debe ser una URL HTTPS válida
  • version debe ser webhook/v1
  • kind debe ser uno de los tipos de evento admitidos (por ejemplo, News/v1, Earnings/v1, Ratings/v1, etc.)
{
  "status": "success"
}

Authorizations

​
Key
string
header
required

Tu clave de la API de Benzinga

Query Parameters

​
destination
string<uri>
required

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

​
version
enum<string>
default:webhook/v1
required

Versión de la API, actualmente webhook/v1

Available options:
webhook/v1
​
kind
enum<string>
default:News/v1
required

Identifica el kind de mensaje para un payload de prueba

Available options:
News/v1,
Signals/v1,
Earnings/v1,
Ratings/v1,
Dividends/v1,
IPOs/v1,
Guidance/v1,
Splits/v1,
OptionActivity/v1,
Conference/v1,
Economics/v1,
Offerings/v1,
MA/v1,
Retail/v1,
FDA/v1,
WIIMs/v1,
SECInsiderTransaction/v1,
GovernmentTrade/v1
​
token
string

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

Response

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

​
status
string
Example:

"success"