Cosmic Notifications - asztroszobéli események webhívásai

Az AstroWay API-t kérés-válasz helyett folyamatos stream-re cseréljük. Ehelyett, hogy a mennyiségben kérdezzük a eget ciklikusan, a folyamatos streamen keresztül az AstroWay küldi a webhookot, amikor az megtörténik (HMAC-SHA256-al lepecsételt, autópóllal és autóelzással “halott” regisztrációk esetén).

Melyek a live események?

Minden ezek az események globális (az ég állapota nem függ a személyes adataktól) - a regisztráltak ugyanazt a payload-t kapják.

Esemény	Regisztráció	Amikor aktiválódik
`retrograde-start`	`POST /v1/webhooks/retrograde-start`	A bolygó (Merkúr-Puszta) rövidül
`retrograde-end`	`POST /v1/webhooks/retrograde-end`	A bolygó kijön a rövidülésből (direkt lesz)
`sign-ingress`	`POST /v1/webhooks/sign-ingress`	A bolygó (Nap + Merkúr-Puszta) belép egy új jegybe
`void-of-course-start`	`POST /v1/webhooks/void-of-course-start`	A Hold “nincs kurzusban” (VOC) időszakának kezdete
`eclipse-alert`	`POST /v1/webhooks/eclipse-alert`	7 napos előrehaladással a nap- vagy Hold-fogyás előtt

Hogyan regisztráljunk

Saját API-kulcsra van szükség, amelyhez a fiókjához van kötve.

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 }

A regisztrációk kezelése: GET /v1/webhooks (lista), GET /v1/webhooks/{id}, DELETE /v1/webhooks/{id}, POST /v1/webhooks/{id}/test (tesztelés a saját URL-jára).

Mi érkezik a saját URL-jára

POST azzal a fejlécvel X-AstroWay-Signature: sha256=<hmac>, X-AstroWay-Event, X-AstroWay-Delivery-Id és a testülettel:

{
  "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
  }
}

A pecsét ellenőrzése

A pecsét az HMAC-SHA256(signing_secret, raw_body) hex értéke. Ellenőrizze a fejlécet X-AstroWay-Signature (a sha256= előtag nélküli):

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));
}

A regisztráció autóelzássa 5 egymás után sikertelen szállítás után (nem-2xx vagy 8 másodpercig tartó időzítés) - aktiválja újra a GET /v1/webhooks → szünet/aktiválás a számláló leállításával.

Az ár

A regisztráció és a regisztrációk kezelése Tier 1 (10 kredit)-es áron történik, ritkán hívják meg. A szállítás az esemény a saját URL-jára ingyenes - nincs külön ár.

Az ár és a szállítás általános információkat tartalmaz.

Hasznos volt?