Notificaciones Cósmicas - Alertas en Astronomía

Convierte la API AstroWay de solicitud-respuesta a stream de eventos. En lugar de solicitar al cielo en un ciclo, usted suscribe una URL de tipo evento y AstroWay envía un webhook en el momento de su ocurrencia (suscripto con HMAC-SHA256, con reintentos y desconexión “muertos” de suscripciones).

Cuáles son los eventos (en vivo)

Todos estos eventos son globales (estado del cielo, no depende de los datos nativos) - los suscriptores reciben el mismo payload.

Evento	Registro	Cuando ocurre
`retrograde-start`	`POST /v1/webhooks/retrograde-start`	El planeta (Mercurio-Plutón) se vuelve retrogrado
`retrograde-end`	`POST /v1/webhooks/retrograde-end`	El planeta sale de la retrogradación (se vuelve directo)
`sign-ingress`	`POST /v1/webhooks/sign-ingress`	El planeta (Sol + Mercurio-Plutón) entra en un nuevo signo
`void-of-course-start`	`POST /v1/webhooks/void-of-course-start`	Comienza el período de la luna “sin curso” (VOC)
`eclipse-alert`	`POST /v1/webhooks/eclipse-alert`	En 7 días antes de un eclipse solar o lunar

¿Cómo suscribirse

Se necesita una API-key vinculada a su cuenta.

curl -X POST https://api.astroway.info/v1/webhooks/retrograde-start \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://your-app.com/hooks/astroway" }'
# { "id": 44, "event": "retrograde-start",
#   "url": "https://your-app.com/hooks/astroway",
#   "signing_secret": "a1b2…",   ← збережіть, ним перевіряється підпис
#   "active": true }

Administrar suscripciones: GET /v1/webhooks (lista), GET /v1/webhooks/{id}, DELETE /v1/webhooks/{id}, POST /v1/webhooks/{id}/test (envío de prueba a su URL).

¿Qué llega a su URL

POST con encabezados X-AstroWay-Signature: sha256=<hmac>, X-AstroWay-Event, X-AstroWay-Delivery-Id y cuerpo:

{
  "event": "retrograde-start",
  "delivered_at": "2026-07-15T12:00:00.000Z",
  "subscription_id": 44,
  "data": {
    "planet": "Mercury",
    "station": "retrograde",
    "exactAt": "2026-07-15T11:48:09.967Z",
    "sign": "Leo",
    "longitude": 142.31
  }
}

Verificar el sello

El sello es HMAC-SHA256(signing_secret, raw_body) en hexadecimal. Verifique con el encabezado X-AstroWay-Signature (sin prefijo sha256=):

import { createHmac, timingSafeEqual } from 'node:crypto';

function verify(rawBody, header, secret) {
  const expected = createHmac('sha256', secret).update(rawBody).digest('hex');
  const got = header.replace(/^sha256=/, '');
  return got.length === expected.length &&
    timingSafeEqual(Buffer.from(got), Buffer.from(expected));
}

La suscripción se desactiva después de 5 envíos consecutivos fallidos (no 2xx o tiempo de espera de 8 segundos) - active nuevamente a través de GET /v1/webhooks → pausa/activación reinicia el contador.

¿Cuál es el costo

Registro y administración de suscripciones - Nivel 1 (10 créditos) por llamada, se realizan raramente. La entrega del evento a su URL no tiene cargo - no hay cargo adicional.

¿Útil?

Запропонувати правку

Última actualización: 10 sept 2026