AAS Webhook (Access Authorization Service)

The AAS Webhook is sent when a user uses a Card to unlock.

Overview

The Access Authorization Service (AAS) Webhook notifies your system when a card-based unlock event occurs. This allows you to track access events in real-time and integrate with your own systems.

When is this webhook sent?

This webhook is triggered when:

• A user successfully uses a Card to unlock a door or access point
• The unlock request is processed by the Access Authorization Service

Webhook Payload

The webhook payload contains information about the unlock event, including:

• Event Type: Identifies this as an AAS unlock event
• Timestamp: When the unlock occurred
• Card Information: Details about the card used
• User Information: Information about the user who performed the unlock
• Location/Access Point: Where the unlock occurred

Example Payload

Code
 
{
  "event": "card_unlock",
  "timestamp": "2024-01-15T10:30:00Z",
  "card": {
    "id": "card_123456",
    "type": "physical"
  },
  "user": {
    "id": "user_789",
    "name": "John Doe"
  },
  "access_point": {
    "id": "door_001",
    "name": "Main Entrance"
  },
  "result": "success"
}

Security

All webhook requests are signed to ensure authenticity. Make sure to verify the webhook signature in your endpoint handler.

Configuration

To receive AAS webhooks, configure your webhook endpoint in the Stayforge Dashboard under Webhook Settings.