GET /public/events
List public change events
Newest first. Private page-watch events are never listed.
所需权限范围: read:signals
参数
type | query | string (product_recall, vehicle_recall, food_drug_recall, end_of_life, end_of_support_upcoming, new_release, …) | Filter by event type |
q | query | string | Full-text search |
region | query | string | Country code; GLOBAL events are always included |
limit | query | integer | Page size |
cursor | query | string | Opaque cursor from the previous page's `nextCursor` |
请求
curl -H "Authorization: Bearer rr_live_…" \
https://realityradar-7h6.pages.dev/api/v1/public/events响应 (200)
{
"items": [
{
"id": "7f1c2b3a-0d9e-4c8b-9a77-1e2f3a4b5c6d",
"eventType": "product_recall",
"title": "Ceramic heater HX-200 recalled for overheating",
"summary": "Voluntary recall of units made 2024-11 to 2025-02.",
"region": "KR",
"sourceUrl": "https://www.safetykorea.kr/recall/…",
"sourcePublishedAt": "2026-10-18T00:00:00.000Z",
"firstSeenAt": "2026-10-19T03:10:00.000Z",
"lastVerifiedAt": "2026-10-22T03:10:00.000Z",
"confidence": 85,
"severity": 80
}
],
"nextCursor": "MjAyNi0xMC0xOV…"
}GET /public/events/{id}
Get one event with sources and evidence
所需权限范围: read:signals
参数
id | path * | string |
请求
curl -H "Authorization: Bearer rr_live_…" \
https://realityradar-7h6.pages.dev/api/v1/public/events/ID响应 (200)
{
"id": "7f1c2b3a-0d9e-4c8b-9a77-1e2f3a4b5c6d",
"eventType": "product_recall",
"title": "Ceramic heater HX-200 recalled for overheating",
"summary": "Voluntary recall of units made 2024-11 to 2025-02.",
"region": "KR",
"sourceUrl": "https://www.safetykorea.kr/recall/…",
"sourcePublishedAt": "2026-10-18T00:00:00.000Z",
"firstSeenAt": "2026-10-19T03:10:00.000Z",
"lastVerifiedAt": "2026-10-22T03:10:00.000Z",
"confidence": 85,
"severity": 80,
"sources": [
{
"key": "kr_safetykorea",
"name": "SafetyKorea",
"tier": "A",
"url": "https://www.safetykorea.kr/…"
}
],
"officialActions": [
"Stop using and contact the manufacturer"
]
}GET /public/entities
List tracked items in the key's workspace
所需权限范围: read:entities
请求
curl -H "Authorization: Bearer rr_live_…" \
https://realityradar-7h6.pages.dev/api/v1/public/entities响应 (200)
{
"items": [
{
"id": "3c0f…",
"workspaceId": "9a1e…",
"entityType": "software_version",
"displayName": "Node.js",
"manufacturer": null,
"modelOrVersion": "18.20.0",
"region": null,
"identifiers": {
"eolProduct": "nodejs"
},
"relationship": "used",
"importance": 3,
"aliases": [],
"exclusions": [],
"createdAt": "2026-10-22T05:00:00.000Z",
"updatedAt": "2026-10-22T05:00:00.000Z"
}
],
"nextCursor": null
}POST /public/entities
Track a new item
Matches against existing events start immediately; hint-driven sources (endoflife.date, OSV, NHTSA, GitHub) are queued for the next worker tick. Free plan: 25 items (409 `plan_limit`). `sourceUrls` pointing at private networks return 422 `ssrf_blocked`.
所需权限范围: write:entities
请求
curl -X POST -H "Authorization: Bearer rr_live_…" -H "Content-Type: application/json" \
-d '{"entityType":"software_version","displayName":"Node.js","modelOrVersion":"18.20.0","identifiers":{"eolProduct":"nodejs"},"relationship":"used"}' \
https://realityradar-7h6.pages.dev/api/v1/public/entities响应 (201)
{
"entity": {
"id": "3c0f…",
"workspaceId": "9a1e…",
"entityType": "software_version",
"displayName": "Node.js",
"manufacturer": null,
"modelOrVersion": "18.20.0",
"region": null,
"identifiers": {
"eolProduct": "nodejs"
},
"relationship": "used",
"importance": 3,
"aliases": [],
"exclusions": [],
"createdAt": "2026-10-22T05:00:00.000Z",
"updatedAt": "2026-10-22T05:00:00.000Z"
}
}GET /public/alerts
List impact assessments (alerts) for the workspace
Latest assessment per event and item, newest first. `reasons` lists the rule codes behind each score.
所需权限范围: read:alerts
参数
limit | query | integer | Page size |
请求
curl -H "Authorization: Bearer rr_live_…" \
https://realityradar-7h6.pages.dev/api/v1/public/alerts响应 (200)
{
"items": [
{
"assessmentId": "5b2e…",
"eventId": "7f1c…",
"entityId": "3c0f…",
"entityName": "Node.js",
"eventType": "end_of_life",
"title": "Node.js 18 (LTS) reached end of life on 2025-04-30",
"summary": "Security fixes are no longer released.",
"impactLevel": "critical",
"matchType": "exact",
"relevance": 60,
"confidence": 85,
"severity": 75,
"reasons": {
"relevance": [
"exact_identifier",
"relationship_owned"
],
"confidence": [
"official_source"
],
"severity": [
"eol_passed"
]
},
"sourceUrl": "https://endoflife.date/nodejs",
"sourcePublishedAt": null,
"firstSeenAt": "2026-10-20T05:07:00.000Z",
"generatedAt": "2026-10-20T05:07:01.000Z"
}
],
"nextCursor": null
}GET /public/webhooks
List webhooks
所需权限范围: manage:webhooks
请求
curl -H "Authorization: Bearer rr_live_…" \
https://realityradar-7h6.pages.dev/api/v1/public/webhooks响应 (200)
{
"items": [
{
"id": "e4d1…",
"url": "https://example.com/hooks/radar",
"minLevel": "high",
"enabled": true,
"failures": 0,
"lastDeliveryAt": null,
"createdAt": "2026-10-22T05:00:00.000Z"
}
],
"nextCursor": null
}POST /public/webhooks
Create a webhook
HTTPS only; private/internal hosts are rejected (422 `ssrf_blocked`). Up to 10 per workspace.
所需权限范围: manage:webhooks
请求
curl -X POST -H "Authorization: Bearer rr_live_…" -H "Content-Type: application/json" \
-d '{"url":"https://example.com/hooks/radar","minLevel":"high"}' \
https://realityradar-7h6.pages.dev/api/v1/public/webhooks响应 (201)
{
"webhook": {
"id": "e4d1…",
"url": "https://example.com/hooks/radar",
"minLevel": "high",
"enabled": true,
"failures": 0,
"lastDeliveryAt": null,
"createdAt": "2026-10-22T05:00:00.000Z"
},
"secret": "whsec_…"
}DELETE /public/webhooks/{id}
Delete a webhook
所需权限范围: manage:webhooks
参数
id | path * | string |
请求
curl -X DELETE -H "Authorization: Bearer rr_live_…" \
https://realityradar-7h6.pages.dev/api/v1/public/webhooks/ID响应 (200)
{
"ok": true
}GET /public/webhooks/{id}/deliveries
Recent deliveries (30-day log)
所需权限范围: manage:webhooks
参数
id | path * | string |
请求
curl -H "Authorization: Bearer rr_live_…" \
https://realityradar-7h6.pages.dev/api/v1/public/webhooks/ID/deliveries响应 (200)
{
"items": [
{
"id": "a0b1…",
"eventType": "alert.created",
"statusCode": 200,
"durationMs": 182,
"attempt": 1,
"ok": true,
"error": null,
"replayOf": null,
"payloadHash": "sha256 hex…",
"createdAt": "2026-10-22T05:01:00.000Z"
}
],
"nextCursor": null
}POST /public/webhooks/{id}/deliveries/{deliveryId}/replay
Replay a delivery
Re-sends the same body with a NEW timestamp and signature. 10 per minute.
所需权限范围: manage:webhooks
参数
id | path * | string | |
deliveryId | path * | string |
请求
curl -X POST -H "Authorization: Bearer rr_live_…" \
https://realityradar-7h6.pages.dev/api/v1/public/webhooks/ID/deliveries/DELIVERYID/replay响应 (200)
{
"ok": true,
"status": 200,
"error": null,
"deliveryId": "c2d3…"
}Webhook 事件
EVENT alert.created
A new alert matched one of your items
Headers: `Content-Type: application/json`, `User-Agent: RealityRadar-Webhook/1.0`, `X-Radar-Signature: t=<unix>,v1=<hex>[,v1=<hex>]`. Compute HMAC-SHA256(secret, `${t}.${rawBody}`) and accept if it equals ANY v1 value and |now − t| ≤ 300 s. Two v1 values are sent for 24 h after a secret rotation. Respond 2xx within 10 s; non-2xx responses are retried and logged.
{
"type": "alert.created",
"alert": {
"id": "…",
"impactLevel": "critical",
"matchType": "exact",
"entityName": "Node.js"
},
"event": {
"id": "…",
"eventType": "end_of_life",
"title": "Node.js 18 (LTS) reached end of life on 2025-04-30",
"summary": "…",
"sourceUrl": "https://endoflife.date/nodejs",
"sourcePublishedAt": null,
"firstSeenAt": "2026-10-20T05:07:00.000Z"
}
}