Disparar un evento de prueba

POSThttps://api.bydomu.com/v1/test/events

This reference is generated from the API’s code, so descriptions are in Spanish. Names, parameters and examples are the same in every language.

Encola la entrega de un evento del catálogo (GET /v1/events) a los webhooks de la organización de prueba suscritos a ese tipo, por la misma cola con reintentos y con la misma firma X-Domu-Signature que un evento real. Los datos salen del registro más reciente de ese objeto en la organización de prueba; si no hay ninguno, van con la forma del catálogo y valores nulos (synthetic: true). El sobre lleva livemode: false y test: true. Solo con una clave de prueba: con una de producción responde 403 TEST_MODE_ONLY.

Permission required

webhooks:write

Required header

X-API-Key · secret key

Access level

Level 3 · with support review

Headers

1 · all optional

Idempotency-Keystring · optional

Clave única de la operación (8-128 caracteres de [a-zA-Z0-9._:-]). Un reintento con la misma clave y el mismo cuerpo devuelve la respuesta original sin repetir la operación. Vive 24 horas.8–128 chars

Body (JSON)

1 · required

typestring · required

1–100 chars

Response 201

TestEvent · 5 fields

dataid · type · livemode · webhooks · synthetic

idstringId del evento de prueba (`evt_test_…`)

typestring

livemodebooleanfalse

webhooksintegerWebhooks suscritos a ese tipo a los que se encoló la entrega

syntheticboolean`true` si no había registros de ese objeto y los datos van con valores nulos

Possible errors

shaped as { "error": { "code", "message" } }

400Datos inválidos: el cuerpo o la query no cumplen el esquema, o `Idempotency-Key` está mal formada.
401UNAUTHORIZED
402PAYMENT_REQUIRED
403FORBIDDEN
404NOT_FOUND
409DUPLICATE
429RATE_LIMITED
500INTERNAL_ERROR