Skip to main content
POST
Test a Cloud Function
Ejecuta el borrador de una función en la nube en una copia de prueba que no puede cambiar nada. Si no hay borrador, la prueba ejecuta el código publicado.

Qué pasa durante una prueba

Envía un ctx con la forma del evento para probar. Sin él, la función recibe {}. Una prueba tiene los mismos límites de tiempo y de solicitudes que una ejecución real. Aparece en el historial con sample_label test_run, pero no cambia run_count, last_run_at ni last_run_status.
Riesgos aceptados de una prueba
  • Un GET que cambia algo en el otro sistema, como un enlace para darse de baja o un webhook que se dispara con GET, se ejecuta de verdad.
  • Las escrituras reciben una respuesta simulada {}. El código que lee campos de esa respuesta, como un ID que espera de vuelta, puede tomar un camino distinto al de producción.
  • Una escritura enviada con globalThis.fetch en vez del fetch o axios que provee Nexor también se retiene, pero no aparece en run.requests.
  • Una conexión TCP directa abierta con una API de sockets no se retiene.

Lee el resultado

  • run.status es success, error o timeout. Un error en tu código es una llamada exitosa con run.status error.
  • run.effects lista los cambios en leads previsualizados.
  • run.requests lista cada solicitud hecha con fetch o axios. Las que tienen blocked: true no se enviaron.
  • run.mode es test.
Un 503 DEPLOYMENT_NOT_CURRENT significa que no se pudo preparar la copia de prueba. No se ejecutó ni se registró nada. Reintenta en un momento. Para verificar una escritura real, publica el código con la función en pausa, y luego actívala y revisa sus próximas ejecuciones.

Autorizaciones

X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_.

Parámetros de ruta

id
string<uuid>
requerido

Cloud Function id.

Cuerpo

application/json
ctx
object

Optional event-shaped ctx to test with. Defaults to {}.

Respuesta

The test ran. A function error or timeout is reported in run.status and run.error, not as an HTTP error.

success
enum<boolean>
requerido
Opciones disponibles:
true
run
object
requerido
test
enum<boolean>
requerido
Opciones disponibles:
true
Última modificación el 6 de octubre de 2026