Últimos eventos de la organización

GEThttps://api.bydomu.com/v1/events/recent

Esta referência é gerada a partir do código da API, por isso as descrições estão em espanhol. Nomes, parâmetros e exemplos são iguais em qualquer idioma.

Hasta 20 eventos reales recientes, del más nuevo al más viejo, opcionalmente de un solo tipo. Pensado para el paso de «datos de ejemplo» al configurar un disparador.

Permissão
events:read
Chaves
Só secreta (de um servidor)

Cabeçalhos

X-API-Keystringobrigatório
Sua chave secreta.

Parâmetros de consulta

typestring
Tipo exacto del catálogo, p. ej. deal.won · ≤ 100 chars

Respostas

200Eventos recientes
400Datos inválidos: el cuerpo o la query no cumplen el esquema, o `Idempotency-Key` está mal formada.
401UNAUTHORIZED · Clave faltante, inválida, desactivada o vencida.
403FORBIDDEN · La clave no puede usar esta operación: falta el scope, es una secreta en el navegador, el nivel de la cuenta no la permite, está suspendida o se alcanzó un tope del plan.
429RATE_LIMITED · Límite de peticiones excedido: el de la clave (`RATE_LIMITED`), el de escrituras de la organización (`TENANT_RATE_LIMITED`) o bloqueo temporal de la IP por claves inválidas.
500INTERNAL_ERROR · Error interno del servidor.
cURL
curl "https://api.bydomu.com/v1/events/recent" \
  -H "X-API-Key: $BYDOMU_API_KEY"
JavaScript
const res = await fetch("https://api.bydomu.com/v1/events/recent", {
  headers: { "X-API-Key": process.env.BYDOMU_API_KEY },
});
const data = await res.json();
Python
import os, requests

r = requests.get(
    "https://api.bydomu.com/v1/events/recent",
    headers={"X-API-Key": os.environ["BYDOMU_API_KEY"]}
)
data = r.json()
Resposta · 200 · exemplo
{
  "data": [
    {
      "id": "5f3a0c1e-7d2b-4f7e-9a51-0b6c1d2e3f40",
      "type": "deal.won",
      "aggregateType": "deal",
      "aggregateId": "clx1deal001",
      "payload": {
        "stageName": "Ganado"
      },
      "actorKind": "USER",
      "actorUserId": "clx1usr001",
      "occurredAt": "2026-09-22T14:30:00.000Z",
      "dispatchStatus": "PENDING",
      "lastError": "timeout"
    }
  ]
}

A chave vai na variável BYDOMU_API_KEY. Os dados do exemplo não são de nenhuma imobiliária.